Skip to main content

HTTP коды статусов

Конверты ответов

Успех

Неподдерживаемый рынок

Возвращается, когда у минта нет жизнеспособного маршрута на любом поддерживаемом DEX. Поле message содержит человекочитаемое и ИИ-читаемое объяснение.

Не проиндексирован

Возвращается, когда минт существует, но ещё не разрешён. Повторите запрос после небольшой задержки.

Ошибка

Общие ответы об ошибках для сбоев валидации, лимитов запросов и серверных ошибок.
SDK парсят все варианты ответов и предоставляют их через тип ExitApiError.

Типы ExitApiError

Каждый SDK предоставляет ExitApiError (или эквивалент) с дискриминатором kind:

Проверка повторяемости

Встроенное поведение повторных попыток

Все SDK включают автоматические повторные попытки с такими настройками по умолчанию: Повторные попытки срабатывают только для ошибок, где isRetryable() возвращает true (сбои транспорта, ответы 5xx и 429).

Настройка политики повторных попыток

Лучшие практики

  • Не повторяйте ошибки 400, 401 или 422. Они указывают на проблему в запросе или аутентификации, которую нужно исправить в коде.
  • Не повторяйте 404 со "status": "unsupported". У минта нет поддерживаемого рынка.
  • Повторите один раз при 404 со "status": "not_indexed". Минту может потребоваться время для разрешения.
  • Используйте экспоненциальную задержку при ответах 429. Встроенные повторные попытки обрабатывают это автоматически.
  • Повторяйте с задержкой при ошибках 502 и 503. Это временные проблемы инфраструктуры.
  • Логируйте детали ошибок, включая kind, status и body для отладки.
  • Если вы видите постоянные ошибки envelope_status, проверьте корректность вашего адреса mint и user_pubkey.