直达礼包接口文档(厂商侧实现)
直发礼包获取游戏区服列表
该接口用于获取指定区服(如果有区服概念)的游戏角色数据。如果游戏支持多个区服,则需要传入 server_id
来指定查询的区服;如果游戏没有区服概念,则无需传入 server_id
参数。
注意
- URL:
/direct-gift/v1/get-server-list
(path 仅供参考,后台配置时须配置完整带path的请求地址) - Method:
GET
- 需要鉴权:是
请求参数
注意
公共参数见 接口公共说明 文档
参数名 | 类型 | 必须 | 描述 |
---|---|---|---|
from | int | 是 | 用于指定查询开始的起点。例如 from=0 表示从第 1 条记录开始返回。 |
limit | int | 是 | 翻页参数,每页的数量 |
openid | string | 是 | TapTap OpenID |
unionid | string | 是 | TapTap UnionID |
成功响应
注意
条件:请求参数合法,并且验签通过。
状态码:200 OK
响应示例:返回游戏列表信息
{
"code": 0,
"msg": "OK",
"data" : {
"servers": [
{
"server_id": "string", // 游戏服 ID
"server_name": "string" // 游戏服名称
}
],
"total": 0
}
}
错误响应
{
"code": 510008,
"msg": "some errors"
}