傳輸限制

新蛋商城API支援種類繁多的應用程式並且每天會處理百萬計的API請求。為了服務的穩定性以及更高的使用性,新蛋商城為API的使用做了以下限制。

基於每個商家

基於每個商家的API請求速率限制。

頻率限制

頻率限制以分鐘為間隔。這表示在一分鐘內您可以提交到指定功能的請求次數有上限。

數據對接限制

某些數據對接功能對於每小時可以上傳請求次數以及每個請求的文件大小都會有限制。這表示您在一小時內可以提交到某個功能的請求次數有上限。且每個請求不能超過最大文件大小限制。

如果您超過限制,將會收到以下回覆:

示例:XML, Response

<?xml version="1.0" encoding="utf-8"?>
<Errors>
    <Error>
        <Code>DF012</Code>
        <Message>Your feed with request ID: 2291326430 exceeded the hourly allowance and cannot be processed. Please submit your feed again after 2016-12-16 11:05:00.</Message>
    </Error>
</Errors>

示例:Json, Response

[
    {
        "Code": "DF012",
        "Message": "Your feed with request ID: 2291326430 exceeded the hourly allowance and cannot be processed. Please submit your feed again after 2016-12-16 11:05:00."
    }
]

HTTP頭文件和Response代碼

下列HTTP頭文件中的元素可用於診斷一個API服務埠的給定頻率限制:

  • X-RateLimit-Limit:基於每個已定義的時間視窗的請求限制
  • X-RateLimit-Remaining:留給該時間窗口的請求次數
  • X-RateLimit-ResetTime:重置剩餘請求的時間
  • X-RecordCount-Limit:商家可上傳的最大記錄數
  • X-RecordCount-Remaining:留給該時間視窗的記錄數
  • X-RecordCount-ResetTime:重置剩餘記錄的時間

API會返回一個HTTP 429“Too Many Requests” 的回覆代碼,回覆主體中會返回下列錯誤資訊:

示例:XML, Response

<?xml version="1.0" encoding="utf-8"?>
<Errors>
    <Error>
        <Code>429</Code>
        <Message>Too many request.</Message>
    </Error>
</Errors>

示例:Json, Response

[
    {
        "Code": "429",
        "Message": "Too many request."
    }
]

更新日期:10/15/2018