​

Errores y comportamiento de reintento

{
  "error": {
    "code": "SOME_CODE",
    "message": "Human-readable explanation",
    "issues": []
  }
}

​

Guía de reintento

• Reintenta los fallos de transporte.
• Reintenta escrituras idempotentes con la misma Idempotency-Key.
• Vuelve a leer el estado duradero después del trabajo asíncrono en lugar de asumir que la primera respuesta está completa.

​

Reglas prácticas

• Trata los fallos del lado del servidor como candidatos a reintento solo cuando la escritura original usó una clave de idempotencia estable.
• Considera las URLs nuevas de descarga de exportación como temporales y vuelve a leerlas desde GET /exports/{exportId} cuando sea necesario.
• Si una mutación ya está en curso o entra en conflicto con el estado actual, inspecciona el code devuelto y reintenta solo cuando la operación siga siendo lógicamente segura.

​

Clientes legibles por máquina

• code
• message
• status
• retryable