# 接入说明 (必看)

## 商户须知

* OMG服务器时区：`UTC+0`，接入方需注意数据统计的时区计算
* OMG提供的接口`code=0`表示成功，要求接入方实现的接口`code=1`表示成功
* OMG平台返回的token有效期为`七天`，超过七天需要重新获取
* 审核通过开户要求后，我方将提供商户后台账号，商户可通过后台查看`app_id`（商户号）和 `key`（签名密钥）
* 文档中`{OMG_API_URL}`需替换为在商户后台界面提供的测试/生产环境接口调用地址
* 文档中`{AGENT_URL}`需替换为接入方在商户后台配置的回调域名地址
* 文档中`{OMG_BACKEND_URL}`需替换为接入方在商户后台的API配置界面获取到后台接口调用域名

***

## 公共参数

{% hint style="info" %}
OMG平台调用接入方所有API接口调用均会包含
{% endhint %}

<table data-full-width="false"><thead><tr><th width="133">参数</th><th width="133">所处位置</th><th width="86">必填</th><th width="143">类型</th><th>说明</th></tr></thead><tbody><tr><td>sign</td><td>header</td><td>是</td><td>string</td><td>签名算法见 <a href="#qian-ming-suan-fa-ji-shi-li">签名算法及示例</a></td></tr><tr><td>trace_id</td><td>url params</td><td>是</td><td>string</td><td>唯一 随机生成</td></tr></tbody></table>

***

## 签名算法及示例

**sign=md5(url上的参数+body中的json字符串+签名密钥key)**

{% hint style="info" %}
**注意这里的body中的json字符串必须是请求中最原始的body中的字符，不能使用json包转出来之后的字符，最终使用小写输出**
{% endhint %}

<table data-full-width="false"><thead><tr><th width="242">类型</th><th>值</th></tr></thead><tbody><tr><td>请求url</td><td><code>{OMG_API_URL}</code>/api/luck/Balance/GetBalance?trace_id=dhf1aboc1iio</td></tr><tr><td>请求方式</td><td>POST</td></tr><tr><td>Content-Type</td><td>"application/json; charset=utf-8"</td></tr><tr><td>请求body中json数据</td><td>{"player_logon_token":"b27cfe9b-f01c-11ee-a0b5-000c2901d9cc","account_id":"1002402","timestamp":1711971655}</td></tr><tr><td>签名密钥key</td><td>39a6581c31ef3203a22edb2daa2ab6d1</td></tr><tr><td>需要md5加密的字符串</td><td>trace_id=dhf1aboc1iio{"player_logon_token":"b27cfe9b-f01c-11ee-a0b5-000c2901d9cc","account_id":"1002402","timestamp":1711971655}39a6581c31ef3203a22edb2daa2ab6d1</td></tr><tr><td>最终加密出来md5字符串</td><td>e3f8dc79e875e46f6755ef540c2d24f3</td></tr></tbody></table>

## 调用返回

当平台返回的http code为200时，为HTTP访问API正常，可正常解析返回结果。其余http错误时为链路异常。 返回的Content-Type为 **"application/json; charset=utf-8"**

```json
{
    "code": 1,
    "msg": "success",
    "data": {
        "glist": [
            {
                "gameid": "9",
                "name": "mine",
                "platform": "1"
            }
        ]
    }
}
```

| 参数名  | 类型      | 说明                              |
| ---- | ------- | ------------------------------- |
| code | integer | 错误编码，为1时表示调用正常，接口返回数据将放在data参数中 |
| msg  | string  | 错误信息                            |
| data | object  | 返回的数据                           |