Skip to main content

Códigos de estado HTTP

Envolventes de respuesta

Éxito

Mercado no soportado

Se devuelve cuando un mint no tiene ruta viable en ningún DEX soportado. El campo message proporciona una explicación legible por humanos y por IA.

No indexado

Se devuelve cuando el mint existe pero aún no ha sido resuelto. Reintenta después de un breve retraso.

Error

Respuestas de error generales para fallos de validación, límites de tasa y errores del servidor.
Los SDKs analizan todas las variantes de respuesta y las exponen a través del tipo ExitApiError.

Tipos de ExitApiError

Cada SDK expone un ExitApiError (o equivalente) con un discriminador kind:

Verificar reintentabilidad

Comportamiento de reintentos integrado

Todos los SDKs incluyen reintentos automáticos con estos valores por defecto: Los reintentos solo se activan para errores donde isRetryable() devuelve true (fallos de transporte, respuestas 5xx y límites de tasa 429).

Personalizar política de reintentos

Mejores prácticas

  • No reintentar errores 400, 401 o 422. Estos indican un problema de solicitud o autenticación que debe corregirse en el código.
  • No reintentar 404 con "status": "unsupported". El mint no tiene mercado soportado.
  • Reintentar una vez en 404 con "status": "not_indexed". El mint puede necesitar un momento para resolverse.
  • Esperar exponencialmente en respuestas 429. El reintento integrado lo maneja automáticamente.
  • Reintentar con backoff en errores 502 y 503. Son problemas transitorios de infraestructura.
  • Registrar detalles del error incluyendo kind, status y body para depuración.
  • Si ves errores consistentes de envelope_status, verifica que tu dirección mint y user_pubkey sean correctos.