接入说明 (必看)

本页面详细介绍了平台接入公共参数,签名算法,多语言配置,通用错误码等说明,接入前请先详细阅读本页面。

商户须知

• OMG服务器时区：UTC+0，接入方需注意数据统计的时区计算

• OMG提供的接口code=0表示成功，要求接入方实现的接口code=1表示成功

• OMG平台返回的token有效期为七天，超过七天需要重新获取

• 审核通过开户要求后，我方将提供商户后台账号，商户可通过后台查看app_id（商户号）和 key（签名密钥）

• 文档中{OMG_API_URL}需替换为在商户后台界面提供的测试/生产环境接口调用地址

• 文档中{AGENT_URL}需替换为接入方在商户后台配置的回调域名地址

• 文档中{OMG_BACKEND_URL}需替换为接入方在商户后台的API配置界面获取到后台接口调用域名

---

公共参数

OMG平台调用接入方所有API接口调用均会包含

参数	所处位置	必填	类型	说明
sign	header	是	string	签名算法见 签名算法及示例
trace_id	url params	是	string	唯一 随机生成

---

签名算法及示例

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

注意这里的body中的json字符串必须是请求中最原始的body中的字符，不能使用json包转出来之后的字符，最终使用小写输出

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

调用返回

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

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

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