Skip to main content

HTTP 상태 코드

응답 엔벨로프

성공

지원되지 않는 마켓

지원되는 DEX에서 실행 가능한 경로가 없는 민트일 때 반환됩니다. message 필드는 사람과 AI가 읽을 수 있는 설명을 제공합니다.

인덱싱되지 않음

민트가 존재하지만 아직 해석되지 않았을 때 반환됩니다. 짧은 지연 후 재시도하세요.

오류

검증 실패, 속도 제한, 서버 오류에 대한 일반 오류 응답입니다.
SDK는 모든 응답 변형을 파싱하고 ExitApiError 타입을 통해 표면화합니다.

ExitApiError 종류

모든 SDK는 kind 판별자가 있는 ExitApiError(또는 동등물)를 노출합니다:

재시도 가능 여부 확인

내장 재시도 동작

모든 SDK에는 다음 기본값으로 자동 재시도가 포함됩니다: isRetryable()true를 반환하는 오류(전송 장애, 5xx 응답, 429 속도 제한)에 대해서만 재시도가 트리거됩니다.

재시도 정책 사용자 정의

모범 사례

  • 400, 401, 422 오류는 재시도하지 마세요. 코드에서 수정해야 할 요청 또는 인증 문제입니다.
  • "status": "unsupported"404재시도하지 마세요. 민트에 지원되는 마켓이 없습니다.
  • "status": "not_indexed"404한 번 재시도하세요. 민트가 해석에 잠시 시간이 필요할 수 있습니다.
  • 429 응답에는 지수 백오프를 적용하세요. 내장 재시도가 자동으로 처리합니다.
  • 502503 오류에는 백오프와 함께 재시도하세요. 일시적인 인프라 문제입니다.
  • 디버깅을 위해 kind, status, body를 포함한 오류 세부사항을 기록하세요.
  • 일관된 envelope_status 오류가 보이면 mint 주소와 user_pubkey가 올바른지 확인하세요.