获取游戏签名
本接口应在服务器端调用,严禁在前端(APP 客户端、网页、小游戏等)直接调用,避免凭证泄露风险。用于获取游戏安全签名。
接口说明
接口英文名 game.getSignature
功能描述 获取指定游戏的签名数据,可用于展示游戏信息或通过签名启动游戏。
注意:本接口强制要求服务通信二次加密和签名:请求参数必须加密并携带签名,响应必须验签后再解密,可有效防止数据篡改与泄露。
调用方式
HTTPS 调用
http
POST /v1/game/signature?access_token=ACCESS_TOKEN调用时,请在接口路径前拼接应用所属服务区域的基础地址,详见服务区域与接口地址。
请求参数 - Query
| 属性 | 类型 | 默认值 | 必填 | 说明 |
|---|---|---|---|---|
| access_token | string | 是 | 接口调用凭证 |
请求参数 - Body
| 属性 | 类型 | 默认值 | 必填 | 说明 |
|---|---|---|---|---|
| game_id | string | 是 | 游戏唯一标识符 |
返回值
返回的 JSON 数据包
| 属性 | 类型 | 说明 |
|---|---|---|
| errcode | int32 | 错误码 |
| errmsg | string | 错误信息 |
| secret_enc_type | number | 包密钥加密方式,0: 明文,1: 异或混淆 + Base64,2: 预留 |
| game_meta_str | string | 游戏元数据 JSON 字符串 |
| game_signature_hash | string | game_meta_str 对应的签名值 |
game_meta_str 字段说明
game_meta_str 是序列化后的 JSON 字符串,解析后结构如下:
| 字段名 | 类型 | 说明 |
|---|---|---|
| game_id | string | 游戏唯一标识符 |
| game_name | object | 游戏名称(多语言) |
| icon | object | 游戏图标 URL(多语言),结构与 game_name 相同 |
| game_icon | string | 游戏图标 URL |
| game_version | string | 游戏版本号 |
| code_version | string | 代码版本号 |
| package_url | string | 游戏资源包下载地址 |
| package_md5 | string | 游戏包 md5 值 |
| package_secret | string | 游戏包解密秘钥,根据 secret_enc_type 决定加密方式 |
| secret_enc_type | number | 包密钥加密方式,0: 明文,1: 异或混淆 + Base64,2: 预留 |
| timestamp | number | 签名生成时间戳(秒) |
| expires | number | 有效期长度(秒) |
| has_sub_package | boolean | 是否存在分包 |
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"
}