获取游戏角色列表
接口说明
当玩家在游戏官网登入时,可以选择在线充值(第三方支付),因此需要开发商提供2个API。第一个是获取游戏区服列表API,第二个是获取游戏角色列表API。
有些玩家付费习惯喜欢在游戏官网充值,这个占比大概为5-10%,虽然占比不高,但是充值的额度是没有限制的。所以一些大R的玩家会习惯于使用游戏官网充值。
请求地址
游戏商自定 http://yourdomain.com/role.php
请求方式(发行商服务器请求游戏商服务器)
GET
请求参数
字段名 | 是否必填 | 类型 | 说明 |
---|---|---|---|
accountId | 是 | string | 发行商平台账号ID |
serverId | 是 | string | 游戏区服ID |
time | 是 | int | 10位时间戳 |
lang | 否 | string | 语言 zh-TW,zh-CN,en,th |
signature | 是 | string | 签名 参考签名规则 |
小提示:
- 通知参数会动态新增,请不要接收固定参数加密签名。
响应结果
返回玩家角色当前时段可购买的商品列表
{
"resultCode":200,
"message":"OK",
"data":[
{
"role_id":"920001000069",
"role_name":"Yuan",
"level":13,
"item":[
{
"pay_id":10001,
"product_id":"com.eskyfun.ss.p0.99",
"name":"60元寶",
"product_type":0,
"price":99,
"base_gold":60,
"extra_gold":6,
"day_gold":0,
"continue_day":0,
"extra_product_id":"{\"product_id\":\"com.eskyfun.ss.gold6\"}",
"expire_time":0
},
{
"pay_id":10002,
"product_id":"com.eskyfun.ss.p4.99",
"name":"300元寶",
"product_type":0,
"price":499,
"base_gold":300,
"extra_gold":300,
"day_gold":0,
"continue_day":0,
"extra_product_id":"{\"product_id\":\"com.eskyfun.ss.gold30\"}",
"expire_time":0
}
]
}
]
}
响应结果字段说明
字段名 | 类型 | 是否必填 | 说明 |
---|---|---|---|
role_id | string | required | 角色ID |
role_name | string | required | 角色名称 |
level | integer | required | 角色等级 |
prefession | string | optional | 职业(可选) |
vip_level | string | optional | vip等级(可选) |
item.pay_id | int | required | 内购商品对应主键ID,必须是整数,保证唯一。不能修改 |
item.product_id | string | required | 内购商品ID |
item.name | string | required | 商品名称 |
item.description | string | required | 商品说明 |
item.product_type | int | required | 0表示基础商品,1表示周卡/月卡/礼包商品。无数据请返回:0 |
item.price | int | required | 价格,精确到美分,例如 4.99USD 商品传 499 |
item.base_gold | int | required | 可获得元宝数量。无数据请返回:0 |
item.extra_gold | int | required | 额外促销获得元宝数量。无数据请返回:0 |
item.day_gold | int | required | 周/月卡每日获得元宝数量。无数据请返回:0 |
item.continue_day | int | required | 周/月卡持续天数。无数据请返回:0 |
item.extra_product_id | string | required | 拓展字段 (透传值) ,即时付款通知接口(extra)字段回传 |
item.expire_time | int | required | 过期时间,单位:秒。0 表示永远不过期 |