protocol_conventions.md 2.3 KB

协议约定

业务规范

  • 每个接入的运营商会在 Luckybet777 平台内部分配一个唯一的代理商帐号,由代理商发展的所有玩家帐号都会归属到该代理名下。
  • 运营商和代理都存在授信额度限制。当运营商或代理的授信额度超出限额时,请与客服联系及时充值额度。
  • 在通讯过程中,为保证数据的正确性和提高程序性能,通讯过程中数据类型与字符串之间的转换按下表规范:
数据类型 类型定义 取值范围
boolean 布尔值 true / false
byte 8 位有符号整数 -128 ~ 127
short 16 位有符号整数 -32768 ~ 32767
int 32 位有符号整数 -2³¹ ~ 2³¹-1
long 64 位有符号整数 -2⁶³ ~ 2⁶³-1
float 32 位浮点数 1.4E-45 ~ 3.4028235E38
double 64 位浮点数 4.9E-324 ~ 1.7976931348623157E308
char 16 位 Unicode 字符 不适用

通讯规范

  • 接口协议

    遵守 JSON-RPC 协议 2.0
    接入 API 访问地址另外提供,请与商务联系获取 API 地址和其他配置信息

  • 接口标准

    数据协议:JSON-RPC Protocol 2.0
    编码要求:UTF-8
    支持 HTTP 头:application/json
    (POST 数据表达式不一样,请参见示例代码)

  • 安全密钥

    代理商密钥:AuthCode,或者称为 API 密钥,包含在《Mega API 代理商资料表单》

  • 摘要算法

    本文档涉签名摘要,称之为 digest
    签名摘要采用 MD5 算法生成,主要形式为:
    md5(random + 交易相关明文字段 + 代理商密钥)
    其中 random 为随机字符串,建议使用 UUID
    摘要中使用哪些交易相关字段(可能为多个字段的组合),请参见对应接口的摘要说明