跳到主内容
版本: 1.x

API 错误

当与您的 WooCommerce 服务器通信时，会出现 API 错误。这些错误以 API 为前缀，并分为以下几类：

分类​

类别代码范围描述
连接API01xxx网络和连通性问题
身份验证API02xxx登录、令牌和权限问题
请求API03xxx发送请求时的问题
响应API04xxx服务器响应的问题
插件/WordPressAPI05xxxWordPress 或 WooCommerce 插件的问题
配置API06xxx设置和配置问题

连接错误​

POS 与您的服务器之间的网络和连通性问题。

代码名称描述
API01001连接超时服务器响应时间过长
API01002连接被拒绝服务器拒绝连接
API01003连接重置连接意外关闭
API01004DNS 解析失败无法解析服务器地址
API01005SSL 证书错误网站的安全证书存在问题
API01006网络不可达无法连接到网络
API01007设备离线您的设备未连接到互联网
API01008网站不可用网站未响应

身份验证错误​

登录、会话和权限的问题。

代码名称描述
API02001无效凭据用户名或密码不正确
API02002令牌已过期您的会话已过期
API02003令牌无效身份验证令牌无效
API02004用户未授权您没有权限执行此操作
API02005权限不足您的用户角色缺少所需权限
API02006API 密钥无效WooCommerce API 密钥无效
API02007令牌刷新失败无法刷新您的会话
API02008刷新令牌无效刷新令牌无效
API02009刷新令牌已过期刷新令牌已过期
API02010需要认证此操作需要认证

请求错误​

发送到服务器的请求出现的问题。

代码名称描述
API03001请求格式无效请求格式不正确
API03002缺少必需参数请求中缺少必需数据
API03003参数值无效某参数的值无效
API03004请求过大请求超出大小限制
API03005超过速率限制短时间内请求过多
API03006不支持的方法不支持该 HTTP 方法
API03007请求队列已满待处理请求过多

响应错误​

从服务器收到的响应出现的问题。

代码名称描述
API04001响应格式无效服务器响应格式无效
API04002意外的响应代码收到意外的 HTTP 状态代码
API04003JSON 响应格式错误JSON 响应已损坏或无效
API04004缺少响应数据响应中缺少预期数据
API04005尝试 JSON 恢复尝试从格式错误的 JSON 中恢复
API04006资源未找到请求的资源不存在（404）

插件/WordPress 错误​

WordPress、WooCommerce 或 WCPOS 插件出现的问题。

代码名称描述
API05001WooCommerce API 已禁用WooCommerce REST API 已禁用
API05002找不到 WCPOS 插件WCPOS 插件未安装
API05003WCPOS 插件过时WCPOS 插件需要更新
API05004WordPress API 已禁用WordPress REST API 已禁用
API05005找不到插件缺少所需的插件

配置错误​

设置和配置出现的问题。

代码名称描述
API06001无效 URL 格式URL 格式无效
API06002缺少 API URL未配置 API URL
API06003站点配置无效站点配置不正确