# API03001: 잘못된 요청 형식

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

서버에 전송된 요청이 예상된 형식이 아닙니다. 요청 구조가 잘못되어 서버가 POS가 요구하는 내용을 이해할 수 없었습니다.

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

* **손상된 데이터** — 전송 전에 데이터가 손상되었습니다.
* **소프트웨어 버그** — POS 애플리케이션의 문제
* **프록시 간섭** — 프록시 또는 방화벽이 요청을 수정했습니다.
* **문자 인코딩 문제** — 특수 문자가 제대로 인코딩되지 않았습니다.

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

이 오류 코드는 서버가 다음과 같은 경우에 발생합니다:

| 서버 코드 | 출처                  |
| --------- | --------------------- |
| HTTP 400  | 모든 서버 응답 (폴백) |

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

### 1. 작업 다시 시도[​](#1-retry-the-action "1. 작업 다시 시도으로 직접 링크")

가끔은 일회성 글리치일 수 있습니다:

* 잠시 기다렸다가 다시 시도하십시오.
* POS를 새로 고치고 다시 시도하십시오.

### 2. 특수 문자 확인[​](#2-check-for-special-characters "2. 특수 문자 확인으로 직접 링크")

특수 문자가 포함된 데이터를 입력하는 경우:

* 이모티콘이나 비정상 기호를 제거해 보십시오.
* 제품 이름 등에 표준 문자를 사용하십시오.

### 3. POS 업데이트[​](#3-update-the-pos "3. POS 업데이트으로 직접 링크")

최신 버전을 실행하고 있는지 확인하십시오:

* 앱 업데이트를 확인하십시오.
* 서버에서 WCPOS 플러그인을 업데이트하십시오.

### 4. 네트워크 구성 확인[​](#4-check-network-configuration "4. 네트워크 구성 확인으로 직접 링크")

프록시 뒤에 있는 경우:

* 프록시가 요청을 수정하지 않는지 확인하십시오.
* 방화벽 규칙을 확인하십시오.
* 다른 네트워크에서 접근해 보십시오.

### 5. 문제 보고[​](#5-report-the-issue "5. 문제 보고으로 직접 링크")

이 문제가 지속적으로 발생하는 경우:

* 오류를 유발하는 작업을 기록하십시오.
* 브라우저 콘솔에서 세부 정보를 확인하십시오 (웹 버전).
* 재현 단계와 함께 [GitHub](https://github.com/wcpos)에 보고하십시오.

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

* [API03002](/ko/error-codes/API03002.md) — 필수 매개변수 누락
* [API03003](/ko/error-codes/API03003.md) — 잘못된 매개변수 값