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 campomessage 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.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,401o422. Estos indican un problema de solicitud o autenticación que debe corregirse en el código. - No reintentar
404con"status": "unsupported". El mint no tiene mercado soportado. - Reintentar una vez en
404con"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
502y503. Son problemas transitorios de infraestructura. - Registrar detalles del error incluyendo
kind,statusybodypara depuración. - Si ves errores consistentes de
envelope_status, verifica que tu direcciónmintyuser_pubkeysean correctos.

