HTTP 상태 코드
응답 엔벨로프
성공
지원되지 않는 마켓
지원되는 DEX에서 실행 가능한 경로가 없는 민트일 때 반환됩니다.message 필드는 사람과 AI가 읽을 수 있는 설명을 제공합니다.
인덱싱되지 않음
민트가 존재하지만 아직 해석되지 않았을 때 반환됩니다. 짧은 지연 후 재시도하세요.오류
검증 실패, 속도 제한, 서버 오류에 대한 일반 오류 응답입니다.ExitApiError 타입을 통해 표면화합니다.
ExitApiError 종류
모든 SDK는 kind 판별자가 있는 ExitApiError(또는 동등물)를 노출합니다:
재시도 가능 여부 확인
내장 재시도 동작
모든 SDK에는 다음 기본값으로 자동 재시도가 포함됩니다:isRetryable()이 true를 반환하는 오류(전송 장애, 5xx 응답, 429 속도 제한)에 대해서만 재시도가 트리거됩니다.
재시도 정책 사용자 정의
모범 사례
400,401,422오류는 재시도하지 마세요. 코드에서 수정해야 할 요청 또는 인증 문제입니다."status": "unsupported"인404는 재시도하지 마세요. 민트에 지원되는 마켓이 없습니다."status": "not_indexed"인404는 한 번 재시도하세요. 민트가 해석에 잠시 시간이 필요할 수 있습니다.429응답에는 지수 백오프를 적용하세요. 내장 재시도가 자동으로 처리합니다.502및503오류에는 백오프와 함께 재시도하세요. 일시적인 인프라 문제입니다.- 디버깅을 위해
kind,status,body를 포함한 오류 세부사항을 기록하세요. - 일관된
envelope_status오류가 보이면mint주소와user_pubkey가 올바른지 확인하세요.

