Errors

GLOBAL BRIDGE API는 표준 HTTP 상태 코드를 사용하여 요청의 성공 또는 실패 여부를 나타냅니다. 실패 시에는 에러의 원인을 파악할 수 있도록 구체적인 에러 객체를 JSON 형식으로 반환합니다.

Error Handling Tip

4xx 에러는 클라이언트 측의 요청 문제(유효성 검사 등)를 나타내며, 5xx 에러는 서버 내부의 일시적인 문제를 나타냅니다.

HTTP Status Codes

200

요청이 성공적으로 처리되었습니다.

400

Bad Request

잘못된 문법이나 필수 파라미터 누락으로 요청을 처리할 수 없습니다.

401

Unauthorized

API 키가 없거나 유효하지 않습니다.

422

Unprocessable Entity

입력값 유효성 검사(Validation)에 실패했습니다.

500

Internal Server Error

서버 내부에서 예상치 못한 오류가 발생했습니다.

Error Response (422 Invalid)

{
  "status": "error",
  "code": "VALIDATION_FAILED",
  "message": "입력 데이터 형식이 올바르지 않습니다.",
  "errors": {
    "url": [
      "유효한 상세페이지 URL 형식이 아닙니다."
    ],
    "translate": [
      "boolean 타입이어야 합니다."
    ]
  }
}

Auth Error (401)

{
  "status": "error",
  "code": "UNAUTHORIZED",
  "message": "유효하지 않은 API 키입니다. 헤더를 확인해주세요."
}

Note: 모든 에러 응답은 일관된 JSON 스키마를 따릅니다.

Errors

HTTP Status Codes

Access Restricted