对接文档

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,不绑定业务字段,双向签名正是为覆盖这一场景。