오류 코드

모든 오류 응답은 형태가 같아요. HTTP 상태와 error.code를 기준으로 처리하세요. error.message는 사람이 읽을 수 있는 영어 텍스트이며 바뀔 수 있어요.

오류 형식

{
  "detail": "…",
  "error": {
    "code": "api.cursor_invalid",
    "message": "The cursor is malformed or was issued for different filters.",
    "details": {"parameter": "cursor"},
    "request_id": "01JB7Q2M4X9V3K8T5N6P0R1S2A",
    "doc_url": "https://developers.sursa.com/errors/api.cursor_invalid"
  }
}

error.code는 이 페이지에 있는 코드예요. error.request_id는 X-Request-Id 헤더 값과 같고, error.doc_url은 이 페이지로 연결돼요.