管理API.
目录
顾客
电子邮件模板
新的
命令
订单退款
交付过程
价格清单
定价订单
参考
脚本
设置
船运
小部件
Webhooks.
构建应用程序
快速开始
指导
教程
建筑渠道
快速开始
指导
教程
建筑店面
管理货币
指导
合作伙伴信息
成为合作伙伴
入门
POS解beplayti体育提现决方案
ERP解beplayti体育提现决方案
PIM解beplayti体育提现决方案
OMS解beplayti体育提现决方案
营销解决方案beplayti体育提现
运输解决方案beplayti体育提现
付款解决方案beplayti体育提现

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.状态页面