# 基礎信息
# 常見錯誤碼
常見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
}