Skip to content

获取游戏签名 ​

本接口应在服务器端调用,严禁在前端(APP 客户端、网页、小游戏等)直接调用,避免凭证泄露风险。用于获取游戏安全签名。

接口说明 ​

接口英文名 game.getSignature

功能描述 获取指定游戏的签名数据,可用于展示游戏信息或通过签名启动游戏。

注意:本接口强制要求服务通信二次加密和签名:请求参数必须加密并携带签名,响应必须验签后再解密,可有效防止数据篡改与泄露。

调用方式 ​

HTTPS 调用 ​

http
POST /v1/game/signature?access_token=ACCESS_TOKEN

调用时,请在接口路径前拼接应用所属服务区域的基础地址,详见服务区域与接口地址。

请求参数 - Query ​

属性类型默认值必填说明
access_tokenstring是接口调用凭证

请求参数 - Body ​

属性类型默认值必填说明
game_idstring是游戏唯一标识符

返回值 ​

返回的 JSON 数据包

属性类型说明
errcodeint32错误码
errmsgstring错误信息
secret_enc_typenumber包密钥加密方式,0: 明文,1: 异或混淆 + Base64,2: 预留
game_meta_strstring游戏元数据 JSON 字符串
game_signature_hashstringgame_meta_str 对应的签名值

game_meta_str 字段说明 ​

game_meta_str 是序列化后的 JSON 字符串,解析后结构如下:

字段名类型说明
game_idstring游戏唯一标识符
game_nameobject游戏名称(多语言)
iconobject游戏图标 URL(多语言),结构与 game_name 相同
game_iconstring游戏图标 URL
game_versionstring游戏版本号
code_versionstring代码版本号
package_urlstring游戏资源包下载地址
package_md5string游戏包 md5 值
package_secretstring游戏包解密秘钥,根据 secret_enc_type 决定加密方式
secret_enc_typenumber包密钥加密方式,0: 明文,1: 异或混淆 + Base64,2: 预留
timestampnumber签名生成时间戳(秒)
expiresnumber有效期长度(秒)
has_sub_packageboolean是否存在分包

game_name 和 icon 的 key 为 BCP 47 语言标签(例如 zh-CN、en-US),default 表示默认值。原有 game_icon 字段保留,可在多语言图标中取不到非空 URL 时回退使用。

调用示例 ​

说明:以下请求示例为加密前的业务数据,实际发送的是加密后的密文并携带签名请求头;返回示例为验签解密后的业务数据。封装与签名规则见服务端 API 签名加密。

请求数据示例 ​

json
{
  "game_id": "xxx"
}

返回数据示例 ​

以下数据仅用于展示返回结构,不可直接用于启动游戏。

json
{
  "errcode": 0,
  "errmsg": "ok",
  "secret_enc_type": 1,
  "game_meta_str": "{\"game_id\":\"2038447928785162241\",\"game_name\":{\"default\":\"opdemo\",\"zh-CN\":\"opdemo\"},\"icon\":{\"default\":\"https://example.com/icon.png\",\"zh-CN\":\"https://example.com/icon-zh.png\"},\"game_icon\":\"https://example.com/icon.png\",\"game_version\":\"3.0.0\",\"code_version\":\"0\",\"package_url\":\"https://example.com/game-package.zip\",\"package_md5\":\"00000000000000000000000000000000\",\"package_secret\":\"ZXhhbXBsZV9wYWNrYWdlX3NlY3JldA==\",\"secret_enc_type\":1,\"timestamp\":1779950105,\"expires\":3600,\"has_sub_package\":false}",
  "game_signature_hash": "xxx"
}