# API02005: 권한 부족

## 이 의미는 무엇인가요[​](#what-this-means "이 의미는 무엇인가요으로 직접 링크")

귀하의 사용자 계정은 이 작업에 필요한 특정 워드프레스 기능이 부족합니다. 기본 접근 권한은 있지만, 시도하려는 특정 작업에는 추가 권한이 필요합니다.

## 일반적인 원인[​](#common-causes "일반적인 원인으로 직접 링크")

* **제한된 사용자 역할** — 귀하의 역할에 필요한 모든 기능이 포함되어 있지 않음
* **기능 할당되지 않음** — 특정 기능이 귀하의 역할에서 누락됨
* **플러그인 제한** — 보안 플러그인이 기능을 제한하고 있음
* **맞춤 역할 문제** — 맞춤 역할에 기능이 누락될 수 있음

## 서버 오류 매핑[​](#server-error-mapping "서버 오류 매핑으로 직접 링크")

서버가 다음을 반환할 때 이 오류 코드가 발생합니다:

| 서버 코드                        | 출처                  |
| -------------------------------- | --------------------- |
| `rest_forbidden`                 | 워드프레스 REST API   |
| `rest_cannot_create`             | 워드프레스 REST API   |
| `rest_cannot_edit`               | 워드프레스 REST API   |
| `rest_cannot_delete`             | 워드프레스 REST API   |
| `woocommerce_rest_cannot_create` | 우커머스 REST API     |
| `woocommerce_rest_cannot_edit`   | 우커머스 REST API     |
| `woocommerce_rest_cannot_delete` | 우커머스 REST API     |
| HTTP 403                         | 모든 서버 응답 (대체) |

## 수정 방법[​](#how-to-fix "수정 방법으로 직접 링크")

### 1. 필요한 기능 확인[​](#1-review-required-capabilities "1. 필요한 기능 확인으로 직접 링크")

POS 작업에 필요한 일반적인 기능:

* `manage_woocommerce` — 일반 우커머스 관리
* `edit_shop_orders` — 주문 생성 및 편집
* `edit_products` — 제품 정보 수정
* `edit_users` — 고객 계정 관리

### 2. 사용자 역할 업그레이드[​](#2-upgrade-user-role "2. 사용자 역할 업그레이드으로 직접 링크")

관리자에게 더 강력한 역할을 할당 요청:

* **상점 관리자** — 전체 우커머스 접근 권한
* **관리자** — 전체 사이트 접근 권한

### 3. 특정 기능 추가[​](#3-add-specific-capabilities "3. 특정 기능 추가으로 직접 링크")

맞춤 역할이 필요하다면, 필요한 기능을 추가하십시오:

```
// Example: Add POS capabilities to a custom role

$role = get_role('your_custom_role');

$role->add_cap('manage_woocommerce');

$role->add_cap('edit_shop_orders');
```

### 4. 플러그인 충돌 확인[​](#4-check-plugin-conflicts "4. 플러그인 충돌 확인으로 직접 링크")

일부 보안 또는 역할 관리 플러그인이 기능을 제한할 수 있습니다:

* 플러그인 설정 검토
* 기능 필터 확인
* 테스트를 위해 일시적으로 비활성화

## 관련 오류[​](#related-errors "관련 오류으로 직접 링크")

* [API02004](/ko/error-codes/API02004.md) — 사용자 권한 없음
* [API02010](/ko/error-codes/API02010.md) — 인증 필요