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. 브라우저/앱 문제 확인
예상치 못하게 로그아웃되는 경우:
- 브라우저 캐시를 지우세요 (웹 버전을 사용하는 경우)
- 쿠키/로컬 스토리지가 차단되는지 확인하세요
- 앱이 데이터를 저장할 권한이 있는지 확인하세요
인증이 필요한 것
대부분의 POS 작업은 인증이 필요합니다:
- 제품 및 고객 보기
- 주문 생성 및 편집
- 결제 처리
- 보고서 접근
초기 로그인 화면만 인증 없이 접근할 수 있습니다.