# API05001: WooCommerce API 비활성화

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

귀하의 사이트에서는 WooCommerce REST API가 비활성화되어 있습니다. WCPOS는 WooCommerce와 통신하고 상점 데이터에 접근하기 위해 REST API가 필요합니다.

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

* **WooCommerce 설정** — REST API가 의도적으로 비활성화됨
* **보안 플러그인** — 보안 플러그인이 API 접근을 차단함
* **호스팅 제한** — 호스트가 REST API 접근을 비활성화함
* **퍼머링크 문제** — REST API에 대해 퍼머링크가 구성되지 않음

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

### 1. WooCommerce REST API 활성화[​](#1-enable-woocommerce-rest-api "1. WooCommerce REST API 활성화으로 직접 링크")

WordPress 관리에서:

1. WooCommerce → 설정 → 고급 → REST API로 이동
2. REST API가 활성화되어 있는지 확인
3. API 키가 생성되었는지 확인

### 2. WordPress REST API 확인[​](#2-check-wordpress-rest-api "2. WordPress REST API 확인으로 직접 링크")

WooCommerce API는 WordPress REST API에 의존합니다:

1. 브라우저에서 `https://yoursite.com/wp-json/` 방문
2. JSON 데이터를 반환해야 함
3. 그렇지 않은 경우 [API05004](/ko/error-codes/API05004.md)를 참조

### 3. 보안 플러그인 확인[​](#3-check-security-plugins "3. 보안 플러그인 확인으로 직접 링크")

API를 차단할 수 있는 일반적인 보안 플러그인:

* **Wordfence** — 방화벽 설정 확인
* **iThemes Security** — REST API 설정 확인
* **All In One WP Security** — 방화벽 규칙 검토

REST API 엔드포인트 또는 POS 애플리케이션을 화이트리스트에 추가합니다.

### 4. .htaccess 확인[​](#4-check-htaccess "4. .htaccess 확인으로 직접 링크")

API 접근을 차단하는 규칙을 찾습니다:

```
# Remove or modify rules blocking /wp-json/

# Ensure mod_rewrite is enabled
```

### 5. 퍼머링크 초기화[​](#5-flush-permalinks "5. 퍼머링크 초기화으로 직접 링크")

경우에 따라 퍼머링크 설정을 새로 고침해야 합니다:

1. 설정 → 퍼머링크로 이동
2. "변경 사항 저장" 클릭 (변경하지 않아도)
3. 이로 인해 재작성 규칙이 재생성됩니다

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

* [API05004](/ko/error-codes/API05004.md) — WordPress API 비활성화
* [API02006](/ko/error-codes/API02006.md) — API 키 유효하지 않음