一、接口规则:
传输方式 | 为保证交易安全性,建议采用HTTPS传输 |
---|---|
提交方式 | 采用HTTP协议中的方法提交 |
数据格式 | 提交和返回数据都为json格式 |
字符编码 | 统一采用UTF-8字符编码 |
签名算法 | MD5 |
签名要求 | 请求和接收数据均需要校验签名,详细方法请参考安全规范-签名算法 |
二、状态码规范
204 No Content
如果更新成功,且客户端属性保持最新,服务器必须返回204 No Content状态码。适用于PUT请求,以及仅调整links,不涉及其它属性的POST, DELETE请求
200 OK
如果服务器接受更新,但是在请求指定内容之外做了资源修改,必须响应200 OK以及更新的资源实例,像是向此URL发出GET请求.
201 Created
如果服务器需要创建一些资源, 比如创建用户, 创建用户数据, 创建资源, 默认API的create方法返回这个状态码.
301 Moved Permanently
被请求的资源已永久移动到新位置, 适用于资源link的变更,服务器做出兼容API.
303 See Other
对应当前请求的响应可以在另一个 URI 上被找到,客户端应该使用 GET 方法进行请求, 适用于旧API往新API的兼容.
400 Bad Request
请求体包含语法错误, 出现本错误服务端应该向客户端发送出错描述
适用于: