管理api
构建应用程序
快速启动
指南
教程
建立渠道
快速启动
指南
教程
建筑店面
管理货币
指南
合作伙伴信息
成为合伙人
开始
POS解决方案
ERP解决方案
PIM解决方案
OMS的解决方案
营销解决方案
运输解决方案
支付解决方案

API状态码

根据请求的结果,BigCommerce API使用不同的HTTP状态码响应请求。错误响应还可能在正文中包含错误消息,以帮助解决问题。

2 xx成功

对于理解并成功处理的请求,将返回2xx个代码。

代码 文本 目的
200 好的 成功得到请求。
201 创建 对于一个成功的帖子要求。
202 接受 对于导致正在创建计划任务以执行实际请求的请求。
204 没有内容 对于没有产生响应的成功请求(例如删除要求)。

3 xx重定向

对于需要进一步处理的请求,将返回3xx个代码。

代码 文本 目的
301 搬到永久 当API路由改变时(不太可能),或者传入请求不安全时(http),该请求将被重定向到安全(https)版本。
304 没有修改 如果请求包含一个if - modified - since头文件,但资源有自指定日期以来已被修改。

4 xx客户端错误

由于请求或数据问题而无法处理的请求将返回4xx代码。

代码 文本 目的
400 坏的请求 在发送格式错误的请求时发出。
401 未经授权 当您的客户端未能提供凭据或其凭据无效时,将发送此响应。
403 被禁止的 当权限不允许操作时返回。
404 未找到 当某个资源不存在或找不到时。
405 方法不允许 找到了资源,但不支持请求方法。在资源上尚未实现的特定方法时发出,或者资源根本不支持该方法。例如,一个/命令是无效的,但a/订单/ {_id_}是有效的。
406 不能接受的 属性中指定响应内容类型时接受不支持的头文件。
409 冲突 由于服务器强加的条件,客户端请求的更改被拒绝。这种响应的确切原因因资源不同而不同。一个例子可能是试图删除一个类别,删除该类别会导致产品孤立。关于冲突以及如何解决冲突的其他信息可能在响应中提供细节部分。
413 请求的实体太大 当客户端请求太多对象时。例如,限制参数超出了最大值。
415 不支持的媒体类型 由于问题退货内容类型头。
422 丢失或无效数据 不能处理请求,因为它忽略了必需的字段,或者因为它包含了无效的数据。更多细节请参见响应。
429 请求太多 当OAuth客户端超过速率限制对于存储的API请求。

5 xx服务器错误

由于API或服务器的内部错误而无法处理的请求将返回5xx个代码。

代码 文本 目的
500 内部服务器错误 当API中发生错误时。
501 没有实现 当发送一个API不支持的请求方法时(例如,痕迹,补丁)。
503 服务不可用 当商店“停止维护”、升级到新版本或由于管理操作或账单问题而暂停时。
507 存储不足 当商店达到资源限制时,根据他们的BigCommerce计划(例如,500个产品的限制)。

故障排除

代码 常见的原因 解决方案
204,301,302 重定向 www或非wwwURL的版本。
400 语法无效,所需数据缺失,内容类型头不见了 双重检查请求体的语法错误和丢失的数据;检查内容类型头。
401 API凭证丢失或无效。 仔细检查的access_tokenclient_id
发送cURL请求与相同的凭据规则应用或配置问题。
403 应用程序缺少必需的OAuth范围,存储 - 所有者帐户已更改,API请求产生的操作超过平台限制,或请求的URL不正确。 再次检查OAuth作用域控制面板>API账户或在开发人员门户>我的应用程序
检查URL。端点和存储散列是否正确?
确保平台的限制目前还没有联系到。
415 请求头指定不支持的内容类型(或标题丢失)。 仔细检查内容类型请求头。
500 BigCommerce中的昂贵API调用或内部服务器错误。 重新尝试请求三到五次,每次尝试之间的延迟至少增加一分钟。
尝试减少被请求的对象数量。通过使用,您可以在v2 API中请求更少的对象?限制={数}。在v2v3API,通过排除某些字段或仅请求某些字段,可以请求更少的对象)。
检查BigCommerce状态页