基礎信息

常見錯誤碼

常見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
    }