주 콘텐츠로 건너뛰기
버전: 1.x

API05001: WooCommerce API 비활성화

의미​

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

일반적인 원인​

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

해결 방법​

1. WooCommerce REST API 활성화​

WordPress 관리에서:

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

2. WordPress REST API 확인​

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

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

3. 보안 플러그인 확인​

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

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

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

4. .htaccess 확인​

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

# Remove or modify rules blocking /wp-json/
# Ensure mod_rewrite is enabled

5. 퍼머링크 초기화​

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

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

관련 오류​

  • API05004 — WordPress API 비활성화
  • API02006 — API 키 유효하지 않음