← Volver al índice de esquemas
RetryStateFull
Estado completo del ciclo de reintentos, incluido en la respuesta de una validación individual (`GET /v1/validations/{id}`). Expone tanto los campos de estado como los detalles de la política configurada.
Propiedades
| Campo | Tipo | Descripción |
|---|---|---|
enabled | boolean | Indica si el ciclo de reintentos está activo para esta validación. |
max_retries | integer | null | Número máximo de reintentos configurado. El tope superior depende del plan (`retry_max_retries`) o del default global `max_retries_cap` (típicamente 5–10). `null` si `enabled=false`. |
interval_seconds | integer | null | Intervalo entre reintentos en segundos (300–86400). `null` si `enabled=false`. |
outcomes | array | null | Resultados de validación que habilitan un reintento (`not_found`, `cep_unavailable`, `error`). `null` si `enabled=false`. |
attempts_completed | integer | Número de reintentos completados hasta el momento. |
next_attempt_at | union | Timestamp del próximo reintento programado. `null` si el ciclo está en estado terminal o si no hay reintentos activos. |
resolved_at | union | Timestamp cuando un reintento resolvió la validación a `valid`. `null` si el ciclo no ha terminado por resolución. |
exhausted_at | union | Timestamp cuando se agotaron los reintentos sin resolución. `null` si el ciclo no ha terminado por agotamiento. |
cancelled_at | union | Timestamp cuando el ciclo fue cancelado explícitamente. `null` si no fue cancelado. |
terminal_state | string | null | Estado terminal del ciclo: `pending` — activo, sin resultado final aún; `resolved` — un reintento obtuvo `valid`; `exhausted` — se agotaron los intentos; `cancelled` — cancelado por el usuario. |
Usado en operaciones
POST /v1/validatePOST /v1/validate-ocrGET /v1/validations/{id}PUT /v1/validations/{id}/retry-policyPOST /v1/validations/{id}/cancel-retriesGET /v1/admin/validations/{id}/raw