에러 코드

성공과 실패 모두 같은 응답 형식을 사용합니다. 실패 응답에는 data가 없습니다.

{
  "status": "PARTNER_API_BRAND_NOT_FOUND",
  "status_code": 404,
  "message": "요청을 처리할 수 없습니다."
}

message는 모든 에러에서 동일합니다. 분기는 반드시 status로 하세요. status_code 는 HTTP 상태코드와 항상 같습니다. 호출 제한, 잘못된 URL 등 모든 실패가 예외 없이 이 형태로 나갑니다.

코드 목록

HTTP	code	의미	대응
400	PARTNER_API_INVALID_PARAMETER	쿼리 파라미터 형식 오류	날짜 형식(YYYY-MM-DD), 기간 순서, enum 값 확인
401	PARTNER_API_KEY_REQUIRED	x-partner-api-key 헤더 누락	헤더 추가
401	PARTNER_API_KEY_INVALID	등록되지 않은 키	키 값 확인, 재발급 문의
401	PARTNER_API_KEY_INACTIVE	폐기된 키	담당자 문의
401	PARTNER_API_KEY_EXPIRED	만료된 키	담당자에게 재발급 요청
403	PARTNER_API_FORBIDDEN	키에 연결된 파트너사 권한 없음	담당자 문의
404	PARTNER_API_BRAND_NOT_FOUND	brand_code 가 없거나 이 키의 범위 밖	브랜드 목록에서 코드 확인
404	PARTNER_API_REVIEW_NOT_FOUND	review_id 가 없거나 이 브랜드 소속이 아님	리뷰 목록에서 id 확인
404	PARTNER_API_USER_NOT_FOUND	user_code 가 없거나 이 브랜드 소속이 아님	유저 목록에서 코드 확인
404	PARTNER_API_NOT_FOUND	존재하지 않는 URL 경로	경로 확인 — 모든 엔드포인트는 /partner/v1/ 하위
429	PARTNER_API_RATE_LIMITED	호출 제한 초과 (분당 100회)	잠시 후 재시도, 폴링 주기 조정
500	PARTNER_API_INTERNAL_ERROR	서버 오류	재시도 후 지속되면 문의

없는 리소스와 권한 밖 리소스는 구분되지 않습니다

BRAND_NOT_FOUND / REVIEW_NOT_FOUND / USER_NOT_FOUND 는 대상이 실제로 없을 때와 다른 조직 소유일 때 모두 같은 코드로 응답합니다.

문의

에러가 지속되면 발생 시각(KST), 호출한 URL, 응답의 status 를 담당자에게 전달해 주세요. API 키 전체는 절대 전달하지 마세요.