跳到主要内容
版本：v4

API 接口

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

查询游戏本体所有权​

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

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

请求参数​

参数名类型必填描述示例
platformstring是所有权对应的平台windows、android
openidstring选填用户 openidWmFzIh+2M2e8r3HqhJAD1A==
unionidstring选填用户 unionidrBDvj7r7GT8ZEyAJrdzxdg==
信息

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

响应参数​

data 中的业务字段如下：

参数名类型描述
data.platformstring所有权对应的平台
data.is_ownedboolean是否拥有对应的应用
data.purchase_timeuint64获得应用的时间戳（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_iduint64是DLC 商品 sku_id233
openidstring选填用户 openid（与 unionid 二选一）WmFzIh+2M2e8r3HqhJAD1A==
unionidstring选填用户 unionid（与 openid 二选一）rBDvj7r7GT8ZEyAJrdzxdg==
信息

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

响应参数​

data 中的业务字段如下：

参数名类型描述
data.platformstring所有权对应的平台
data.is_ownedboolean是否拥有对应的 DLC
data.purchase_timeuint64获得 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
}