# API 오류

API 오류는 WooCommerce 서버와 통신할 때 발생합니다. 이 오류는 `API`로 접두사가 붙으며 다음과 같은 카테고리로 구성되어 있습니다:

## 카테고리[​](#categories "카테고리으로 직접 링크")

| 카테고리                                       | 코드 범위 | 설명                                      |
| ---------------------------------------------- | --------- | ----------------------------------------- |
| [연결](#connection-errors)                     | API01xxx  | 네트워크 및 연결 문제                     |
| [인증](#authentication-errors)                 | API02xxx  | 로그인, 토큰 및 권한 문제                 |
| [요청](#request-errors)                        | API03xxx  | 발신 요청의 문제                          |
| [응답](#response-errors)                       | API04xxx  | 서버 응답의 문제                          |
| [플러그인/워드프레스](#pluginwordpress-errors) | API05xxx  | 워드프레스 또는 WooCommerce 플러그인 문제 |
| [구성](#configuration-errors)                  | API06xxx  | 설정 및 구성 문제                         |

***

## 연결 오류[​](#connection-errors "연결 오류으로 직접 링크")

POS와 서버 간의 네트워크 및 연결 문제.

| 코드                                    | 이름               | 설명                                           |
| --------------------------------------- | ------------------ | ---------------------------------------------- |
| [API01001](/ko/error-codes/API01001.md) | 연결 시간 초과     | 서버가 응답하는 데 너무 오랜 시간이 걸렸습니다 |
| [API01002](/ko/error-codes/API01002.md) | 연결 거부          | 서버가 연결을 거부했습니다                     |
| [API01003](/ko/error-codes/API01003.md) | 연결 재설정        | 연결이 예기치 않게 종료되었습니다              |
| [API01004](/ko/error-codes/API01004.md) | DNS 확인 실패      | 서버 주소를 확인할 수 없습니다                 |
| [API01005](/ko/error-codes/API01005.md) | SSL 인증서 오류    | 사이트의 보안 인증서에 문제가 있습니다         |
| [API01006](/ko/error-codes/API01006.md) | 네트워크 도달 불가 | 네트워크에 도달할 수 없습니다                  |
| [API01007](/ko/error-codes/API01007.md) | 기기 오프라인      | 기기가 인터넷에 연결되어 있지 않습니다         |
| [API01008](/ko/error-codes/API01008.md) | 웹사이트 사용 불가 | 웹사이트가 응답하지 않습니다                   |

## 인증 오류[​](#authentication-errors "인증 오류으로 직접 링크")

로그인, 세션 및 권한 문제.

| 코드                                    | 이름                    | 설명                                          |
| --------------------------------------- | ----------------------- | --------------------------------------------- |
| [API02001](/ko/error-codes/API02001.md) | 잘못된 인증 정보        | 사용자 이름 또는 비밀번호가 올바르지 않습니다 |
| [API02002](/ko/error-codes/API02002.md) | 토큰 만료               | 세션이 만료되었습니다                         |
| [API02003](/ko/error-codes/API02003.md) | 잘못된 토큰             | 인증 토큰이 유효하지 않습니다                 |
| [API02004](/ko/error-codes/API02004.md) | 사용자 권한 없음        | 이 작업을 수행할 권한이 없습니다              |
| [API02005](/ko/error-codes/API02005.md) | 권한 부족               | 사용자 역할에 필요한 권한이 없습니다          |
| [API02006](/ko/error-codes/API02006.md) | API 키 유효하지 않음    | WooCommerce API 키가 유효하지 않습니다        |
| [API02007](/ko/error-codes/API02007.md) | 토큰 갱신 실패          | 세션을 갱신할 수 없습니다                     |
| [API02008](/ko/error-codes/API02008.md) | 갱신 토큰 유효하지 않음 | 갱신 토큰이 유효하지 않습니다                 |
| [API02009](/ko/error-codes/API02009.md) | 갱신 토큰 만료          | 갱신 토큰이 만료되었습니다                    |
| [API02010](/ko/error-codes/API02010.md) | 인증 필요               | 이 작업을 수행하기 위해 인증이 필요합니다     |

## 요청 오류[​](#request-errors "요청 오류으로 직접 링크")

서버에 전송된 요청의 문제.

| 코드                                    | 이름                 | 설명                                  |
| --------------------------------------- | -------------------- | ------------------------------------- |
| [API03001](/ko/error-codes/API03001.md) | 잘못된 요청 형식     | 요청 형식이 올바르지 않습니다         |
| [API03002](/ko/error-codes/API03002.md) | 필수 매개변수 누락   | 요청에서 필수 데이터가 누락되었습니다 |
| [API03003](/ko/error-codes/API03003.md) | 잘못된 매개변수 값   | 매개변수에 잘못된 값이 있습니다       |
| [API03004](/ko/error-codes/API03004.md) | 요청 크기 초과       | 요청이 크기 제한을 초과합니다         |
| [API03005](/ko/error-codes/API03005.md) | 속도 제한 초과       | 짧은 시간에 너무 많은 요청이 있습니다 |
| [API03006](/ko/error-codes/API03006.md) | 지원하지 않는 메서드 | HTTP 메서드가 지원되지 않습니다       |
| [API03007](/ko/error-codes/API03007.md) | 요청 대기열 가득 참  | 보류 중인 요청이 너무 많습니다        |

## 응답 오류[​](#response-errors "응답 오류으로 직접 링크")

서버에서 수신한 응답의 문제.

| 코드                                    | 이름                  | 설명                                       |
| --------------------------------------- | --------------------- | ------------------------------------------ |
| [API04001](/ko/error-codes/API04001.md) | 잘못된 응답 형식      | 서버 응답 형식이 유효하지 않습니다         |
| [API04002](/ko/error-codes/API04002.md) | 예기치 않은 응답 코드 | 예기치 않은 HTTP 상태 코드를 받았습니다    |
| [API04003](/ko/error-codes/API04003.md) | 잘못된 JSON 응답      | JSON 응답이 손상되었거나 유효하지 않습니다 |
| [API04004](/ko/error-codes/API04004.md) | 응답 데이터 누락      | 응답에서 예상 데이터가 누락되었습니다      |
| [API04005](/ko/error-codes/API04005.md) | JSON 복구 시도        | 잘못된 JSON에서 복구를 시도했습니다        |
| [API04006](/ko/error-codes/API04006.md) | 리소스 없음           | 요청된 리소스가 존재하지 않습니다 (404)    |

## 플러그인/워드프레스 오류[​](#pluginwordpress-errors "플러그인/워드프레스 오류으로 직접 링크")

워드프레스, WooCommerce 또는 WCPOS 플러그인 문제.

| 코드                                    | 이름                     | 설명                                      |
| --------------------------------------- | ------------------------ | ----------------------------------------- |
| [API05001](/ko/error-codes/API05001.md) | WooCommerce API 비활성화 | WooCommerce REST API가 비활성화되었습니다 |
| [API05002](/ko/error-codes/API05002.md) | WCPOS 플러그인 없음      | WCPOS 플러그인이 설치되지 않았습니다      |
| [API05003](/ko/error-codes/API05003.md) | WCPOS 플러그인 구형      | WCPOS 플러그인을 업데이트해야 합니다      |
| [API05004](/ko/error-codes/API05004.md) | 워드프레스 API 비활성화  | 워드프레스 REST API가 비활성화되었습니다  |
| [API05005](/ko/error-codes/API05005.md) | 플러그인 없음            | 필수 플러그인이 설치되지 않았습니다       |

## 구성 오류[​](#configuration-errors "구성 오류으로 직접 링크")

설정 및 구성 문제.

| 코드                                    | 이름               | 설명                            |
| --------------------------------------- | ------------------ | ------------------------------- |
| [API06001](/ko/error-codes/API06001.md) | 잘못된 URL 형식    | URL 형식이 유효하지 않습니다    |
| [API06002](/ko/error-codes/API06002.md) | API URL 누락       | 구성된 API URL이 없습니다       |
| [API06003](/ko/error-codes/API06003.md) | 잘못된 사이트 구성 | 사이트 구성이 올바르지 않습니다 |