API02010: 需要认证
这意味着什么
您尝试执行的操作需要认证,但您当前未登录。POS 需要有效的凭据才能访问此资源。
常见原因
- 未登录 — 您尚未进行认证
- 会话已清除 — 您的会话已被清除或已过期
- 访问受保护资源 — 该资源需要认证
- 应用数据已清除 — 存储的凭据已被移除
服务器错误映射
当服务器返回以下内容时,会触发此错误代码:
| 服务器代码 | 来源 |
|---|---|
rest_login_required | WordPress REST API |
jwt_auth_no_auth_header | JWT 认证插件 |
| HTTP 401 | 任何服务器响应(回退) |
如何修复
1. 登录
如果您尚未登录:
- 打开 POS 登录屏幕
- 输入您的 WordPress 凭据
- 完成认证过程
2. 检查会话状态
如果您认为自己已登录:
- 您的会话可能已过期
- 查找 API02002(令牌已过期)以获取更多详细信息
- 重新登录以恢复访问权限
3. 验证服务器配置
确保API端点已正确配置:
- WooCommerce REST API 必须启用
- WCPOS 插件必须处于活动状态
- 认证端点必须可访问
4. 检查浏览器/应用问题
如果您意外被注销:
- 清除浏览器缓存(如果使用的是网络版本)
- 检查 cookies/本地存储没有被阻止
- 验证应用有权限存储数据
什么需要认证?
大多数 POS 操作需要认证:
- 查看产品和客户
- 创建和编辑订单
- 处理支付
- 访问报告
只有初始登录屏幕在没有认证的情况下可访问。