API03001: 잘못된 요청 형식
의미
서버에 전송된 요청이 예상된 형식이 아닙니다. 요청 구조가 잘못되어 서버가 POS가 요구하는 내용을 이해할 수 없었습니다.
일반적인 원인
- 손상된 데이터 — 전송 전에 데이터가 손상되었습니다.
- 소프트웨어 버그 — POS 애플리케이션의 문제
- 프록시 간섭 — 프록시 또는 방화벽이 요청을 수정했습니다.
- 문자 인코딩 문제 — 특수 문자가 제대로 인코딩되지 않았습니다.
서버 오류 매핑
이 오류 코드는 서버가 다음과 같은 경우에 발생합니다:
| 서버 코드 | 출처 |
|---|---|
| HTTP 400 | 모든 서버 응답 (폴백) |
수정 방법
1. 작업 다시 시도
가끔은 일회성 글리치일 수 있습니다:
- 잠시 기다렸다가 다시 시도하십시오.
- POS를 새로 고치고 다시 시도하십시오.
2. 특수 문자 확인
특수 문자가 포함된 데이터를 입력하는 경우:
- 이모티콘이나 비정상 기호를 제거해 보십시오.
- 제품 이름 등에 표준 문자를 사용하십시오.
3. POS 업데이트
최신 버전을 실행하고 있는지 확인하십시오:
- 앱 업데이트를 확인하십시오.
- 서버에서 WCPOS 플러그인을 업데이트하십시오.
4. 네트워크 구성 확인
프록시 뒤에 있는 경우:
- 프록시가 요청을 수정하지 않는지 확인하십시오.
- 방화벽 규칙을 확인하십시오.
- 다른 네트워크에서 접근해 보십시오.
5. 문제 보고
이 문제가 지속적으로 발생하는 경우:
- 오류를 유발하는 작업을 기록하십시오.
- 브라우저 콘솔에서 세부 정보를 확인하십시오 (웹 버전).
- 재현 단계와 함께 GitHub에 보고하십시오.