对接文档
接口列表
获取应用配置
GET
ini
获取应用公告
GET
notice
卡密登录
POST
kmlogon
卡密解绑
POST
kmunmachine
获取应用文件
GET
getfile
心跳验证
POST
kmheartbeat
子用户注册
POST
userreg
子用户登录
POST
userlogon
子用户心跳验证
POST
userheartbeat
子用户信息查询
POST
getinfo
卡密充值(会员/积分)
POST
card
GET验证码
POST
sendcode
找回密码
POST
seekpass
修改用户资料
POST
useredit
获取用户信息
POST
userinfo
用户签到
POST
userdiary
Sign签名计算方式
GET
sign
Sign签名计算方式
请求参数
| 字段名 | 变量名 | 必填 | 类型 | 说明 |
|---|---|---|---|---|
| 数据签名 | sign | 否 | String | 开启签名时必填,值为 MD5 |
返回示例
Sign = 取MD5值( 按提交顺序拼接的「字段名=值&...」 + SecretKey )
注意:签名串中不包含 sign 本身,也不包含 value、app、api 等非业务字段;SecretKey 只拼接一次,串中间没有任何固定值。
示例(卡密登录,假设 SecretKey = TESTSECRETKEY):
提交参数:kami=TGM2026&markcode=ABC123DEF&t=1790000000
签名串 :kami=TGM2026&markcode=ABC123DEF&t=1790000000&TESTSECRETKEY
Sign :91dc419f59d69265dfdef54d92142861
(以上为本平台实测值,对接时可按此格式重放验证;若应用开启了 data 加密,sign 需放入加密包内一并提交)
说明
所有接口的 POST 参数(除 sign 外)按 key=value 用 & 连接,最后拼上 SecretKey(即应用配置中的通信密钥 secretkey),再取 MD5 值即为 sign。签名开关开启时需携带该参数。
【双向签名校验(sign_switch=both 专属)】
当应用的签名验证选择 both(双向)时,服务端会对每个响应额外计算响应签名,并通过 HTTP 响应头返回:
头名称:X-JG-Sign
计算方式:MD5(响应体原文 + SecretKey)
说明:响应体原文即客户端收到的完整响应内容(若开启了返回加密,则为加密后的密文)。
客户端收到响应后,用同样的 SecretKey 对响应体原文计算 MD5,与 X-JG-Sign 比对:一致则响应未被篡改;不一致说明响应被篡改或服务端非官方,应丢弃。
注意:该头仅在签名验证=both 时返回;request 模式下不返回,客户端无需校验。ini/notice/getfile 接口不参与双向签名。
作用:防止抓包篡改响应内容(如修改到期时间 msg.vip、伪造返回码)。check 字段仅绑定 time 与 value,不绑定业务字段,双向签名正是为覆盖这一场景。
【双向签名校验(sign_switch=both 专属)】
当应用的签名验证选择 both(双向)时,服务端会对每个响应额外计算响应签名,并通过 HTTP 响应头返回:
头名称:X-JG-Sign
计算方式:MD5(响应体原文 + SecretKey)
说明:响应体原文即客户端收到的完整响应内容(若开启了返回加密,则为加密后的密文)。
客户端收到响应后,用同样的 SecretKey 对响应体原文计算 MD5,与 X-JG-Sign 比对:一致则响应未被篡改;不一致说明响应被篡改或服务端非官方,应丢弃。
注意:该头仅在签名验证=both 时返回;request 模式下不返回,客户端无需校验。ini/notice/getfile 接口不参与双向签名。
作用:防止抓包篡改响应内容(如修改到期时间 msg.vip、伪造返回码)。check 字段仅绑定 time 与 value,不绑定业务字段,双向签名正是为覆盖这一场景。