도매꾹 Open API는 오류가 발생하면 API 종류와 관계없이 동일한 형식의 표준 오류 메시지를 반환합니다.연동 시스템에서는 이 형식을 기준으로 공통 파싱/예외처리 로직을 구성할 수 있습니다.
일부 API는 통신이 정상적으로 이루어진 경우, 성공/오류와 무관하게 HTTP 200으로 응답될 수 있습니다.이 경우 성공/실패는 응답 본문(code/message) 기준으로 판단해 주세요.
표준 오류 메시지는 API 요청 설정에 따라 XML 또는 JSON 형식으로 반환됩니다.오류 메시지는 아래 5개 요소로 구성됩니다.
code: 오류코드message: 오류내용dcode: 상세코드dmessage: 상세내용date: API 호출일시
XML
JSON
오류가 발생하면 먼저 응답 본문의 code 를 확인해 주세요.단, 호출 제한 등 일부 경우에는 HTTP 상태 코드(예: 429) 로도 오류가 반환될 수 있습니다.
구분 | 코드 | 의미(요약) | 주요 원인 | 해결 방법 |
|---|---|---|---|---|
API code | 1 | 서버 접근이 금지되었습니다 | 서버 점검/접속 제한 상태 | 점검 종료 후 다시 호출해 주세요. |
API code | 10 | 올바른 요청이 아닙니다 | 필수 파라미터 누락/형식 오류/값 오류 | 레퍼런스 기준으로 요청 파라미터와 값을 다시 확인해 주세요. |
API code | 20 | API 인증 실패 | 등록되지 않은 API KEY 또는 API Key 누락 | API Key를 확인하고, 필요 시 재발급 후 호출해 주세요. |
API code | 30 | API 호출 실패 | 서비스 접근 거부(프로토콜 등) | HTTPS로 호출해 주세요. |
API code | 31 | DB 호출 실패 | 일시적인 서비스 장애/지연 | 잠시 후 다시 시도해 주세요. |
API code | 401 | 권한이 없습니다 | 이용요청 인증이 필요한 API | 별도 계약/권한이 필요한 API인지 확인해 주세요. |
API code | 404 | 알 수 없는 서비스입니다 | 존재하지 않는 Open API 호출 | 요청 API/mode 값 및 URL 경로를 확인해 주세요. |
HTTP | 404 | Not Found | 호출 URL이 잘못됨 | URL을 다시 확인하고 정확한 경로로 호출해 주세요. |
HTTP | 429 | Too Many Requests | 호출 허용량 초과 | 분당 180회 초과 시 3분 차단, 하루 15,000회 초과 시 당일 자정까지 API 사용이 제한됩니다. |
연동 중 오류가 반복된다면 아래 항목을 먼저 확인해 주세요.
API Key 누락/오타: 모든 요청에 API Key가 포함되어 있는지 확인
HTTPS로 호출했는지: 일부 오류(code 30)는 HTTP 호출에서 발생
파라미터 형식/필수값 누락: code 10 발생 시 레퍼런스 기준으로 재검증
호출량 초과(429): 대량 호출 시 간격 조절(재시도는 백오프 권장)
문자 인코딩: 문자열 파라미터는 EUC-KR 기준으로 구성 권장(지원되지 않는 문자를 포함하면 오류/오작동이 발생할 수 있음)
Open API를 안전하고 안정적으로 이용하기 위해 아래 내용을 확인해 주세요.
보안 안내
로그인/세션 기반 API를 사용하는 경우, 사용 중 id/sid 등 인증 정보가 외부에 노출되지 않도록 주의해 주세요.
사용이 끝나면 로그아웃 API 호출을 권장합니다.
테스트 안내
현재 별도의 개발(샌드박스) 환경은 제공하지 않습니다.
주문서 생성·결제 등 주요 기능 테스트는 연동 환경에 맞게 필요한 범위 내에서 자체적으로 진행해 주세요.
이용 제한(비정상적 사용) 안내
과도한 API 호출로 서비스에 영향을 주는 경우
동일한 오류를 대량으로 반복 발생시키는 경우
비정상적인 요청을 반복적으로 유지하는 경우
VPN 등으로 IP 정보를 숨기려는 경우
서비스 안정성과 보호를 위해 위와 같은 사용 패턴이 감지될 경우,
이용 제한이 적용될 수 있습니다.
도매꾹 Open API 사용시 문의가 있을 경우(techsupport@ggook.com)로 보내주시면 담당자가 확인 후 연락드리겠습니다.