# 基礎信息

# 常見錯誤碼

常見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
    }
Last Updated: 2/12/2021 下午2:36:56