API状态代码
BigCommerce API根据请求的结果响应具有不同HTTP状态代码的请求。错误响应可能还包括身体中的错误消息,以帮助解决问题。
2xx成功
2xx代码返回成功理解和处理的请求。
代码 | 文本 | 目的 |
---|---|---|
200. | 好吧 | 成功得到 和放 要求。 |
201. | 创造了 | 成功邮政 请求。 |
202. | 公认 | 用于导致创建计划任务以执行实际请求的请求。 |
204. | 无内容 | 对于没有响应的成功请求(例如删除 请求)。 |
3xx重定向
为需要进一步行动的请求返回3xx代码。
代码 | 文本 | 目的 |
---|---|---|
301. | 永久搬进来 | 当API路由已更改(不太可能)时,或者输入请求不安全(http. ),请求将被重定向到安全(https. ) 版本。 |
304. | 不修改 | 如果请求包括一个,将发送此响应IF-FORIFIED - 自从 标题,但资源有不是自指定日期以来已被修改。 |
4xx客户端错误
由于请求或数据问题而无法处理的请求,返回4xx代码。
代码 | 文本 | 目的 |
---|---|---|
400 | 错误的请求 | 发送格式错误的请求时发出。 |
401. | 未经授权的 | 当客户端无法提供凭据或其凭据无效时,将发送此响应。 |
403. | 禁忌 | 当权限不允许操作时返回。 |
404. | 没有找到 | 当特定资源不存在或找不到时。 |
405. | 不允许的方法 | 找到了资源,但不支持请求方法。当某个特定的方法尚未在某个资源上实现,或该资源根本不支持该方法时发出。例如,一个放 在/订单 无效,但是放 在/订单/ {_ id_} 已验证。 |
406. | 不能接受的 | 当客户端指定响应内容类型时接受 不支持的标题。 |
409. | 冲突 | 由于服务器施加的条件,拒绝客户端请求的更改。此响应的确切原因将因下一个资源而异。一个例子可能是尝试删除删除将导致产品孤立的类别。有关冲突的其他信息,以及如何解决方法,可能会在响应中提供细节 部分。 |
413. | 请求实体过大 | 当客户端请求太多对象时。例如,限制 参数超过了最大值。 |
415. | 不支持的媒体类型 | 由于问题而返回内容类型 标题。 |
422. | 丢失或无效的数据 | 无法处理请求,因为它省略了必填字段,或者因为它包含无效数据。有关更多详细信息,请参阅响应。 |
429. | 太多的请求 | 当OAuth客户端超过速率限制对于存储商店的API请求。 |
5xx服务器错误
由于API或服务器的内部错误,无法处理的请求返回5xx代码。
代码 | 文本 | 目的 |
---|---|---|
500. | 内部服务器错误 | 在API中发生错误时。 |
501. | 未实现 | 当API不支持的请求方法时(例如,跟踪 那修补 )。 |
503. | 暂停服务 | 当商店“维护下来”时升级到新版本,或者由于管理操作或计费问题而被暂停。 |
507. | 存储空间不足 | 根据他们的商店达到了资源的限制BigCommerce计划(例如,500-产品限制)。 |
故障排除
代码 | 常见的原因 | beplayti体育提现 |
---|---|---|
204.那301., 和302. | 重定向 | 试试万维网 或非万维网 版本的URL。 |
400 | 语法无效,所需数据丢失,内容类型 丢失的标题 |
用于语法错误和缺少数据的双重检查请求正文;查看内容类型 标题。 |
401. | API凭据缺失或无效。 | 仔细检查Access_Token. 和client_id. 。 |
将CURL请求发送到与规则应用程序或配置问题相同的凭据。 | ||
403. | 应用程序缺乏所需的OAuth范围,商店所有者帐户更改,操作导致的API请求超过平台限制,或请求的URL是不正确的。 | 双重检查OAuth范围控制面板>API帐户或者开发人员门户>我的应用程序。 |
检查URL。是端点和商店哈希正确吗? | ||
确保平台限制尚未达到。 | ||
415. | 请求标题指定不支持的内容类型 (或标题丢失)。 |
再检查一遍内容类型 请求标题。 |
500. | 昂贵的API调用或BIGCommerce中的内部服务器错误。 | 重新尝试请求三到五次,在尝试之间增加至少一分钟的延迟。 |
尝试减少所要求的对象数量。您可以使用v2 api中的较少对象?限制= {count} 。在v2. 和v3. API,可以通过排除某些字段或仅请求某些字段来请求更少的对象)。 |
||
检查BigCommerce.状态页面。 |