外观
接入指引
362 字约 1 分钟
2025-03-13
说明
- 实现请求头参数封装、签名逻辑
- 组装接口参数,拼接域名+接口路径进行接口调用
请求
域名
生产环境:
请求方式
POST请求,application/json格式
请求头
app_key
与app_parent_id
一一对应,由我方提供
字段 | 类型 | 必填 | 描述 |
---|---|---|---|
Content-Type | string | 是 | application/json |
Client | string | 是 | 公共参数client字段,json格式化字符串串进行base64encode后的值,见下方公共参数说明 |
Authorization | string | 是 | 签名,把body json字符串、Client、app_key字符串拼接后md5加密得到32位结果转小写 |
Client参数说明
字段 | 类型 | 必填 | 描述 |
---|---|---|---|
timestamp | int | 是 | 毫秒时间戳 |
app_parent_id | int | 是 | 游戏ID |
os | int | 是 | 系统,1->IOS;2->Android;9->其他;10->PC; |
extra | string | 否 | 额外参数,值默认为空字符串 |
请求参数示例
app_parent_id=1
app_key="12345678912345678912345678912345"
Client json字符串:{"timestamp":1741683812,"app_parent_id":1,"os":1}
Clinet base 64字符串:eyJ0aW1lc3RhbXAiOjE3NDE2ODM4MTIsImFwcF9wYXJlbnRfaWQiOjEsIm9zIjoxfQ==
body json字符串:{"server_id":"1","user_id":"2","role_id":"3","role_name":"4","role_lv":"5","role_vip":"6","role_power":"7","text":"一句包含敏感词的话"}
Authorization签名字符串:{"server_id":"1","user_id":"2","role_id":"3","role_name":"4","role_lv":"5","role_vip":"6","role_power":"7","text":"一句包含敏感词的话"}eyJ0aW1lc3RhbXAiOjE3NDE2ODM4MTIsImFwcF9wYXJlbnRfaWQiOjEsIm9zIjoxfQ==12345678912345678912345678912345
Authorization签名小写:cce1490cafee785479ddb130c3bdf414
响应
统一返回json,格式如下
字段 | 类型 | 描述 |
---|---|---|
code | int | 返回码,正常为0,其他均为失败 |
msg | string | 返回信息 |
data | struct | 返回结果data |
{
"code": 0,
"msg": "success",
"data": {
*****
}
}