# API04001: 잘못된 응답 형식

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

서버가 응답했지만 응답 형식이 POS가 기대했던 것이 아닙니다. 서버는 JSON 데이터를 반환해야 하지만 다른 것이 수신되었습니다.

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

* **PHP 오류가 표시됨** — JSON 이전에 PHP 오류가 출력되고 있습니다.
* **플러그인 충돌** — 다른 플러그인이 콘텐츠를 출력하고 있습니다.
* **유지 관리 모드** — 사이트가 유지 관리 페이지를 표시하고 있습니다.
* **잘못된 콘텐츠 유형** — 서버가 JSON 대신 HTML을 보내고 있습니다.
* **캐싱 문제** — 캐시된 오류 페이지가 제공되고 있습니다.

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

### 1. 사이트 확인[​](#1-check-your-site "1. 사이트 확인으로 직접 링크")

브라우저에서 WordPress 사이트를 방문하세요:

* 정상적으로 표시되나요?
* 보이는 오류가 있나요?
* 유지 관리 모드인가요?

### 2. PHP 오류 확인[​](#2-check-for-php-errors "2. PHP 오류 확인으로 직접 링크")

`wp-config.php`에서 디버깅을 임시로 활성화하세요:

```
define('WP_DEBUG', true);

define('WP_DEBUG_LOG', true);

define('WP_DEBUG_DISPLAY', false);
```

`wp-content/debug.log`에서 오류를 확인하세요.

### 3. REST API 직접 테스트[​](#3-test-the-rest-api-directly "3. REST API 직접 테스트으로 직접 링크")

브라우저에서 `https://yoursite.com/wp-json/`를 방문하세요:

* JSON 데이터를 반환해야 합니다.
* HTML 또는 오류를 보면 문제가 있습니다.
* 플러그인 관련 출력을 확인하세요.

### 4. 캐싱 임시 비활성화[​](#4-disable-caching-temporarily "4. 캐싱 임시 비활성화으로 직접 링크")

캐싱 플러그인이 만료된 응답을 제공할 수 있습니다:

* 모든 캐시를 지우세요.
* 캐싱 플러그인을 임시로 비활성화하세요.
* REST API를 캐싱에서 제외하세요.

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

플러그인이 모든 페이지에서 콘텐츠를 출력하는 경우:

1. 필수하지 않은 모든 플러그인을 비활성화하세요.
2. POS를 테스트하세요.
3. 플러그인을 하나씩 다시 활성화하세요.

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

* [API04003](/ko/error-codes/API04003.md) — 잘못된 JSON 응답
* [API05005](/ko/error-codes/API05005.md) — 플러그인 찾을 수 없음