REST API

请求方式：GET / POST，依据各接口规格说明

数据格式：JSON

路径前缀：/gameapi/v2

调用示例：

POST /gameapi/v2/create_player HTTP/1.1
Content-Type: application/json; charset=utf-8
Host: <api server>
Connection: close
Content-Length: 255

请求参数：

{
  "merchant_code": "04e17735ba374dcd898746c6ac8118e4",
  "auth_token": "59ddb8dd71f8494485ff200f78bc4dba",
  "username": "merchant.player2",
  "sign": "20fbee96a0f436a6d8386b192a569a27bcc1c689"
}

返回响应：

{
  "success": true,
  "code": 0,
  "detail": {
    "id": 11216,
    "role": 3,
    "username": "o2p1632998628",
    "company": 11198
  }
}

标准返回结果格式：

• success：布尔值，表示此接口操作成功或失败。如果失败，则 message 字段会提供错误信息。
• code：返回码，仅用于向后兼容。
• message：字符串，操作失败（success: false）时返回具体错误信息，详细内容请见错误列表。
• detail：具体业务返回数据，依据各接口规格定义。

• 根据受欢迎程度每月更新

大厅

经典游戏

怪兽系列

刮刮乐

老虎机

彩票

服务器域名或 IP

隐藏对外服务器域名或 IP，请勿直接暴露给玩家。

IP 白名单

服务器上需设置 IP 白名单。

测试环境需在管理后台增加访问游戏前端的 IP 白名单。

商户号与安全密钥

均为 32 位字符（字母与数字），由邮件发送提供。

测试密钥：dd35aPO0bd186dc6ace6We2e0fb48s70

签名密钥

均为 32 位字符（字母与数字），由邮件发送提供。

测试密钥：dd35aPO0bd186dc6ace6We2e0fb48s70

参数签名规则

1. 所有参数默认编码为 UTF-8。
2. 忽略参数名为 sign 的字段、值为空或类型为 object 的字段。
3. 所有有效参数名按字母升序排序。
4. 将排序后的所有非空参数值（不含 key）依次拼接成一个字符串，在末尾拼接上签名密钥，最后使用 SHA1 加密算法生成签名。

签名示例：

假设商户的签名密钥为 SIGN_KEY_EXAMPLE，需要对以下参数对象进行签名：

{
  "b": 1.1,
  "a": 1,
  "d": "some string",
  "e": "",
  "c": true,
  "sign": "abcdefg",
  "g": {
    "x": 1,
    "y": 2
  },
  "f": null
}

计算签名步骤如下：

1. 忽略值为空、类型为 object 及 key 为 sign 的字段，得到：

   {
     "b": 1.1,
     "a": 1,
     "d": "some string",
     "c": true
   }
   

2. 将 key 按字母升序排序，得到：

   {
     "a": 1,
     "b": 1.1,
     "c": true,
     "d": "some string"
   }
   

3. 将 value（不需 key）依次拼接，并在末尾拼接签名密钥，得到签名之前的字符串：

   11.1truesome stringSIGN_KEY_EXAMPLE
   

4. 对该字符串进行 SHA1 加密，得到最终签名值：

   91bef33b208ba98ac2d889b9c4e996651ca58146
   

身份认证

• 使用 merchant_code（商户号）和 secure_key（安全密钥）调用登录接口获取 auth_token。
• 每次调用业务 API 时，均需在请求参数中带上此 auth_token。