# <font>协议约定</font>

## 业务规范

- 每个接入的运营商会在 **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  
  > 摘要中使用哪些交易相关字段（可能为多个字段的组合），请参见对应接口的摘要说明