에러 코드
v1 API 공통 응답 형식과 주요 에러 코드입니다.
응답 형식
오류 시에도 HTTP 상태 코드와 함께 errors 배열이 반환됩니다.
json
{
"data": null,
"meta": {},
"errors": [
{
"code": "rate_limit_exceeded",
"message": "API 호출 한도를 초과했습니다."
}
]
}에러 코드표
구분설명
401 invalid_api_key
키 없음·형식 오류·회수됨
401 api_key_expired
만료된 키
403 api_access_denied
무료 플랜 또는 API 미포함 플랜
403 insufficient_scope
스코프 부족
403 plan_limit_exceeded
플랜 한도(예: 품목 수) 초과
403 ecount_managed
이카운트 동기 리소스 수정 시도
400 validation_error
필드 누락·형식 오류
400 bulk_not_supported
다건·배열 요청
429 rate_limit_exceeded
분당 호출 초과
404
리소스를 찾을 수 없음