# API02010: 需要认证

## 这意味着什么[​](#what-this-means "直接链接到 这意味着什么")

您尝试执行的操作需要认证，但您当前未登录。POS 需要有效的凭据才能访问此资源。

## 常见原因[​](#common-causes "直接链接到 常见原因")

* **未登录** — 您尚未进行认证
* **会话已清除** — 您的会话已被清除或已过期
* **访问受保护资源** — 该资源需要认证
* **应用数据已清除** — 存储的凭据已被移除

## 服务器错误映射[​](#server-error-mapping "直接链接到 服务器错误映射")

当服务器返回以下内容时，会触发此错误代码：

| 服务器代码                | 来源                   |
| ------------------------- | ---------------------- |
| `rest_login_required`     | WordPress REST API     |
| `jwt_auth_no_auth_header` | JWT 认证插件           |
| HTTP 401                  | 任何服务器响应（回退） |

## 如何修复[​](#how-to-fix "直接链接到 如何修复")

### 1. 登录[​](#1-log-in "直接链接到 1. 登录")

如果您尚未登录：

1. 打开 POS 登录屏幕
2. 输入您的 WordPress 凭据
3. 完成认证过程

### 2. 检查会话状态[​](#2-check-session-status "直接链接到 2. 检查会话状态")

如果您认为自己已登录：

* 您的会话可能已过期
* 查找 [API02002](/zh-CN/error-codes/API02002.md)（令牌已过期）以获取更多详细信息
* 重新登录以恢复访问权限

### 3. 验证服务器配置[​](#3-verify-server-configuration "直接链接到 3. 验证服务器配置")

确保API端点已正确配置：

* WooCommerce REST API 必须启用
* WCPOS 插件必须处于活动状态
* 认证端点必须可访问

### 4. 检查浏览器/应用问题[​](#4-check-for-browserapp-issues "直接链接到 4. 检查浏览器/应用问题")

如果您意外被注销：

* 清除浏览器缓存（如果使用的是网络版本）
* 检查 cookies/本地存储没有被阻止
* 验证应用有权限存储数据

## 什么需要认证？[​](#what-requires-authentication "直接链接到 什么需要认证？")

大多数 POS 操作需要认证：

* 查看产品和客户
* 创建和编辑订单
* 处理支付
* 访问报告

只有初始登录屏幕在没有认证的情况下可访问。

## 相关错误[​](#related-errors "直接链接到 相关错误")

* [API02001](/zh-CN/error-codes/API02001.md) — 无效凭据
* [API02002](/zh-CN/error-codes/API02002.md) — 令牌已过期

***