## 接口协议和规则
**1.文档描述**
本文档主要用于在天马工场业务系统和区块链交互提供的一些基础服务接口
**2.接口统一约定**
****
2.1 通信协议
所有接口均采用HTTPS协议,并且都采用HTTP POST/GET/PUT/DELETE的方式来调用。详情见下方请求示例。
****
2.2 数据类型
数据格式采用JSON格式数据包装,并且返回的数据编码均为UTF-8格式。对于不同的接口,所返回的JSON格式的数据会有所不同,在之后的示例中会给出。
****
2.3 编码格式
接受UTF-8编码格式的编码信息。传入的参数和返回的结果都是UTF-8格式的。
****
2.4 错误码定义
针对于不同的接口,正确的返回结果会在每个接口的返回结果中单独定义,如果在请求和相应的过程中发生错误,那么错误的返回则是统一的格式。
****
| code | msg |
| --- | --- |
| 200 | 成功 |
| 500 | 调用失败原因描述 |
****
>### *其他约定*
>通过HTTP传给接口的参数区分大小写。严禁使用测试接口地址,做线上业务应用。