시작하기

에러 코드

RDPLINE API 호출 시 확인할 수 있는 공통 에러 코드와 응답 예시를 안내합니다.

공통 에러 응답

모든 오류 응답은 success, status, message, errorCode로 구성됩니다. data 필드는 정상 응답에만 포함됩니다.

필드

설명

success

오류 응답에서는 항상 false입니다.

status

HTTP 상태 코드입니다.

message

오류 원인을 설명하는 영문 메시지입니다. 잘못된 파라미터와 원인을 확인할 수 있습니다.

errorCode

오류의 범주를 나타내는 문자열입니다. 값이 고정되어 있어 애플리케이션의 오류 분기 기준으로 사용하기에 적합합니다.

오류 응답 예시

{  "success": false,  "status": 400,  "message": "The required parameter is missing: page",  "errorCode": "INVALID_ARGUMENT"}

errorCode 목록

errorCode는 오류의 넓은 범주를 나타내고, 구체적인 원인은 message로 구분합니다. 예를 들어 파라미터 관련 오류는 INVALID_ARGUMENT로 반환되며, 어떤 파라미터가 문제인지는 message에서 확인할 수 있습니다.

errorCode

HTTP

발생 상황

message

INVALID_ARGUMENT

400

필수값 누락, 형식·범위 오류, 조회 방식에 맞지 않는 필드, 잘못된 커서, 잘못된 검색 정렬값, page × size 상한 초과, 본문 파싱 실패 등 요청 파라미터 오류

필수 파라미터 누락

The required parameter is missing: <parameter>

예시: The required parameter is missing: page

값·형식·조합 오류

The parameter is invalid: <parameter>

예시: The parameter is invalid: publishedAtStart

UNAUTHENTICATED

401

API Key 누락 또는 유효하지 않은 API Key

Missing API Key / Invalid or expired API Key

PERMISSION_DENIED

403

유효한 ACTIVE 계약이 없거나 회사 식별자를 확인할 수 없어 접근 권한이 없는 경우

Company is unauthorized or does not exist. / No active client contract found.

RESOURCE_EXHAUSTED

429

처리율 제한 초과

Too many requests. Please retry later.

INTERNAL

500

서버 내부 오류

An unexpected error occurred.

UNAVAILABLE

503

백엔드 또는 검색 엔진 장애로 서비스가 일시적으로 불가능한 경우

Service is temporarily unavailable. Please try again later.

DEADLINE_EXCEEDED

504

검색 엔진 응답 시간이 초과된 경우

The search provider did not respond in time. Please try again later.