오류 및 제한

SUMUN은 HTTP 상태 코드와 기계가 읽을 수 있는 오류 코드를 함께 사용합니다. 연동 서비스는 사람이 읽는 오류 문구가 아니라 이 값을 기준으로 처리해야 합니다.

HTTP 상태	의미
400	입력값 또는 요청 형식 오류
401	API Key가 없거나 올바르지 않음
403	API Key에 필요한 Scope가 없음
404	리소스 또는 분석 결과를 찾지 못함
409	현재 리소스 상태와 요청이 충돌함
413	요청이 허용 크기를 초과함
429	쿼터, 동시 실행 또는 요청 제한에 도달함
5xx	SUMUN 또는 외부 의존성에서 오류가 발생함

일시적인 429와 5xx 오류만 Exponential Backoff와 Jitter를 적용해 재시도하세요. Retry-After가 있으면 해당 값을 따르세요. 잘못된 입력, 인증과 Scope 오류는 요청을 수정하기 전까지 재시도하지 마세요.

오픈 베타 기간의 일일 쿼터와 남은 Request Unit은 사용량 대시보드에 표시된 값을 기준으로 합니다.