← Volver al índice de esquemas

CancelValidationRetriesAttributes

Atributos del recurso devuelto al cancelar los reintentos pendientes de una validación (estado de reintento completo).

Propiedades

CampoTipoDescripción
retry_stateobjectEstado 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.
enabledbooleanIndica si el ciclo de reintentos está activo para esta validación.
max_retriesinteger | nullNú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_secondsinteger | nullIntervalo entre reintentos en segundos (300–86400). `null` si `enabled=false`.
outcomesarray | nullResultados de validación que habilitan un reintento (`not_found`, `cep_unavailable`, `error`). `null` si `enabled=false`.
attempts_completedintegerNúmero de reintentos completados hasta el momento.
next_attempt_atTimestampUTC | nullTimestamp del próximo reintento programado. `null` si el ciclo está en estado terminal o si no hay reintentos activos.
resolved_atTimestampUTC | nullTimestamp cuando un reintento resolvió la validación a `valid`. `null` si el ciclo no ha terminado por resolución.
exhausted_atTimestampUTC | nullTimestamp cuando se agotaron los reintentos sin resolución. `null` si el ciclo no ha terminado por agotamiento.
cancelled_atTimestampUTC | nullTimestamp cuando el ciclo fue cancelado explícitamente. `null` si no fue cancelado.
terminal_statestring | nullEstado 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. `null` si la validación no tiene ciclo de reintentos.

Usado en operaciones

  • POST /v1/validations/{id}/cancel-retries