传输限制

新蛋商城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