API 接口

调用接口前，请阅读 接口公共说明，了解接口域名、公共请求参数、签名方法及通用响应结构。

查询游戏本体所有权

查询指定用户是否拥有当前游戏。买断制游戏的售卖说明见 买断制游戏介绍。

• 接口地址：/license/v1/check-app-ownership
• 请求方式：GET

请求参数

参数名	类型	必填	描述	示例
platform	string	是	所有权对应的平台	windows、android
openid	string	选填	用户 openid	WmFzIh+2M2e8r3HqhJAD1A==
unionid	string	选填	用户 unionid	rBDvj7r7GT8ZEyAJrdzxdg==

info

openid 和 unionid 必须传入一个来标识用户。

响应参数

data 中的业务字段如下：

参数名	类型	描述
data.platform	string	所有权对应的平台
data.is_owned	boolean	是否拥有对应的应用
data.purchase_time	uint64	获得应用的时间戳（Unix Time）。未拥有则不返回

请求示例

curl -X 'GET' \
  'https://cloud.tapapis.cn/license/v1/check-app-ownership?client_id=vuqhc4vl4sy13yopbu&openid=WmFzIh%2B2M2e8r3HqhJAD1A%3D%3D&platform=windows' \
  -H 'accept: application/json' \
  -H 'X-Tap-Nonce:XphYC2P1c0' \
  -H 'X-Tap-Ts:1724398444' \
  -H 'X-Tap-Sign:NHTBum18IkFft+TkPvKEx3GJAATqFbGCnmxuv3r7KKQ='

响应示例

未拥有：

{
  "data": {
    "platform": "windows",
    "is_owned": false
  },
  "now": 1724398496,
  "success": true
}

已拥有：

{
  "data": {
    "platform": "windows",
    "is_owned": true,
    "purchase_time": 1672531200
  },
  "now": 1724398496,
  "success": true
}

查询 DLC 所有权

查询指定用户是否拥有指定的 DLC 商品。商品配置见 DLC 商品。

• 接口地址：/license/v1/check-dlc-ownership
• 请求方式：GET

请求参数

参数名	类型	必填	描述	示例
sku_id	uint64	是	DLC 商品 sku_id	233
openid	string	选填	用户 openid（与 unionid 二选一）	WmFzIh+2M2e8r3HqhJAD1A==
unionid	string	选填	用户 unionid（与 openid 二选一）	rBDvj7r7GT8ZEyAJrdzxdg==

info

openid 和 unionid 必须传入一个来标识用户。

响应参数

data 中的业务字段如下：

参数名	类型	描述
data.platform	string	所有权对应的平台
data.is_owned	boolean	是否拥有对应的 DLC
data.purchase_time	uint64	获得 DLC 的时间戳（Unix Time）。未拥有则不返回

请求示例

curl -X 'GET' \
  'https://cloud.tapapis.cn/license/v1/check-dlc-ownership?client_id=vuqhc4vl4sy13yopbu&openid=WmFzIh%2B2M2e8r3HqhJAD1A%3D%3D&sku_id=233' \
  -H 'accept: application/json' \
  -H 'X-Tap-Nonce:XphYC2P1c0' \
  -H 'X-Tap-Ts:1724398444' \
  -H 'X-Tap-Sign:NHTBum18IkFft+TkPvKEx3GJAATqFbGCnmxuv3r7KKQ='

响应示例

已拥有：

{
  "data": {
    "platform": "windows",
    "is_owned": true,
    "purchase_time": 1672531200
  },
  "now": 1724398496,
  "success": true
}

未拥有：

{
  "data": {
    "platform": "windows",
    "is_owned": false
  },
  "now": 1724398496,
  "success": true
}