基础信息

常见错误码

常见HTTP错误码

类型:

• 4XX 错误码用于指示错误的请求内容、行为、格式

• 5XX 错误码用于指示BingX服务侧的问题

错误码:

• 400 Bad Request – Invalid request format 请求格式无效

• 401 Unauthorized – Invalid API Key 无效的API Key

• 403 Forbidden – You do not have access to the requested resource 请求无权限

• 404 - Not Found 没有找到请求

• 429 - Too Many Requests 请求太频繁被系统限流

• 418 - 表示收到429后继续访问，于是被封了

• 500 - Internal Server Error – We had a problem with our server 服务器内部错误

• 504 - 表示API服务端已经向业务核心提交了请求但未能获取响应(特别需要注意的是504代码不代表请求失败，而是未知。很可能已经得到了执行，也有可能执行失败，需要做进一步确认)

注意:

• 如果失败，response body 带有错误描述信息

• 每个接口都有可能抛出异常

时间戳规范

除非另外指定，API中的所有时间戳均以微秒为单位返回。

请求的时间戳必须在API服务时间的30秒内，否则请求将被视为过期并被拒绝。如果本地服务器时间和API服务器时间之间存在较大的偏差，那么我们建议您使用通过查询API服务器时间来更新http header。

例如 1587091154123

数字规范

为了保持跨平台时精度的完整性，十进制数字作为字符串返回。建议您在发起请求时也将数字转换为字符串以避免截断和精度错误。

整数（如交易编号和顺序）不加引号。

频率限制

如果请求过于频繁系统将自动限制请求。

REST API

• 行情接口：通过IP限制公共接口的调用，每1秒最多60个请求。

• 账户和交易接口：通过用户ID限制私人接口的调用，每1秒最多10个请求。

• 某些接口的特殊限制在具体的接口上注明

查询系统时间

HTTP请求

    # Request
    POST api/v1/common/server/time

请求方式

GET / POST

请求参数

无

返回值说明

参数名	参数类型	描述
code	Int64	错误码，0表示成功，不为0表示异常失败
msg	String	错误信息提示
currentTime	Int64	系统当前时间，单位毫秒

    # Response
    {
        "code": 0,
        "msg": "",
        "currentTime": 1534431933321
    }