# API04006: 리소스 없음

## 의미[​](#what-this-means "의미으로 직접 링크")

서버가 요청한 리소스를 찾을 수 없습니다. 이는 일반적으로 HTTP 404 상태 코드에 해당하며, 접근하려는 제품, 주문, 고객 또는 다른 리소스가 존재하지 않음을 나타냅니다.

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

* **레코드 삭제** — 서버에서 리소스가 삭제됨
* **잘못된 ID** — 잘못되었거나 구식 ID가 사용되고 있음
* **동기화 문제** — 로컬 데이터가 더 이상 존재하지 않는 리소스를 참조함
* **URL 잘못 설정** — API 엔드포인트가 잘못됨
* **퍼머링크 문제** — 워드프레스 퍼머링크가 새로 고쳐져야 함

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

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

| 서버 코드       | 출처                |
| --------------- | ------------------- |
| `rest_no_route` | 워드프레스 REST API |
| HTTP 404        | 모든 서버 응답      |

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

### 1. 리소스 존재 여부 확인[​](#1-check-if-the-resource-exists "1. 리소스 존재 여부 확인으로 직접 링크")

리소스가 여전히 귀하의 WooCommerce 사이트에 존재하는지 확인합니다:

* 워드프레스 관리자에 로그인
* 관련 섹션(제품, 주문, 고객)으로 이동
* ID 또는 이름으로 항목 검색

### 2. 로컬 데이터 새로 고침[​](#2-refresh-local-data "2. 로컬 데이터 새로 고침으로 직접 링크")

리소스가 서버 측에서 삭제된 경우:

1. POS 설정을 엽니다
2. 관련 데이터 섹션으로 이동
3. 로컬 데이터를 업데이트하기 위해 동기화/새로 고침을 트리거합니다
4. 삭제된 항목이 로컬에서 제거되어야 합니다

### 3. 워드프레스 퍼머링크 확인[​](#3-check-wordpress-permalinks "3. 워드프레스 퍼머링크 확인으로 직접 링크")

여러 리소스가 발견되지 않는 경우:

1. 워드프레스 관리에서 **설정 → 퍼머링크**로 이동
2. **변경 사항 저장**을 클릭합니다 (변경 없이도)
3. 이로써 퍼머링크 구조가 새로 고쳐집니다

### 4. API 경로 확인[​](#4-verify-api-routes "4. API 경로 확인으로 직접 링크")

REST API를 직접 테스트합니다:

```
https://yoursite.com/wp-json/wc/v3/products
```

이것이 404를 반환하면 서버 구성 문제가 있을 수 있습니다.

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

REST API 경로가 누락된 경우:

1. WooCommerce가 활성화되어 있는지 확인합니다
2. WCPOS 플러그인이 활성화되어 있는지 확인합니다
3. 다른 플러그인을 잠시 비활성화하여 테스트합니다

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

* [API04001](/ko/error-codes/API04001.md) — 잘못된 응답 형식
* [API04002](/ko/error-codes/API04002.md) — 예기치 않은 응답 코드
* [API05002](/ko/error-codes/API05002.md) — WCPOS 플러그인 없음