币安RestApi翻译（binance rest-api translation）（2）

币安RestApi翻译（binance rest-api translation）

英文文档地址：https://github.com/binance-exchange/binance-official-api-docs/blob/master/rest-api.md

币安公开REST接口（2017-12-01）

概述

• 接入端基础地址：https://api.binance.com

• 返回格式为JSON或者Array

• 返回的数据以时间为序，老的信息先返回，新的后返回

• 与时间相关的单位都是毫秒

• 返回的HTTP代码若是4xx形式的，表示不符合请求规范，是调用者自身的问题

• 代码：429，表示超过频率限制（我理解是请求太频繁了）

• 如果收到429代码后继续发送请求，则返回418

• 5xx形式的返回代码，表示服务器端发生了内部错误，不是调用端的责任

• 代码504：表示API已成功发送消息，但是超时未响应。特别需要注意的是，此时执行的结果是未知的，可能成功，也可能失败

• 返回错误信息的格式如下：

  {
    "code": -1121,
    "msg": "Invalid symbol."
  }
  

• 更详尽的错误码信息定义，在另一篇文档中描述

• 对于GET操作，参数作为一个查询字符串来传递

• 对于POST\PUT\DELETE操作，你既可以使用查询字符串，也可以使用类型为application/x-www-form-urlencoded的请求body。当然，也可以把二者混合使用

• 参数是无序的

• 如果同一个参数同时使用了查询字符串和请求body，那么优先使用请求字符串的

=============================================================
币安API文档翻译（Binance APIs documents tranlation）（1） https://steemit.com/cn/@brysj22952/api-binance-apis-documents-tranlation-1