PUThttps://api.veriko.mx/v1/users/me/retry-policy

Establecer la política de reintentos en una cuenta de usuario

Audiencia: public
Autenticación: API key
Permiso: users:update_self

Fija la política de reintentos que se aplicará a la cuenta del usuario autenticado.

Desde que la política se guarda, se aplica a toda validación futura que no contenga la suya propia en el cuerpo.

La comprobación es estricta: un valor por encima de un tope se rechaza, no se recorta en silencio, y cualquier desvío responde con un estado HTTP 422 (con retry_policy_invalid en el cuerpo).

Con enabled=false, los demás campos se ignoran y la política queda guardada como desactivada.

Acepta Idempotency-Keyopcional, que evita guardar dos veces lo mismo cuando la red obliga a reintentar.

Parámetros
Parámetro	Ubicación	Tipo	Obligatorio	Descripción
`Idempotency-Key`	header	`string`	opcional	Llave opcional que garantiza que la petición se procese exactamente una vez dentro de un TTL de 24 horas. Los reintentos con la misma llave y el mismo cuerpo devuelven la respuesta cacheada con la cabecera `Idempotent-Replayed: true` (sin re-disparar webhooks) y sin crear una nueva validación. p. ej. `11111111-2222-3333-4444-555555555555`

Parámetros
Parámetro	Tipo	Obligatorio	Descripción
`retry_policy`	object	obligatorio	Política de reintentos de una validación: activación, límite, intervalo y resultados elegibles.
`enabled`	boolean	opcional	`true` cuando el ciclo de reintentos está activo. Si es `false`, los demás campos pueden ser ignorados. p. ej. `true`
`max_retries`	integer (≥ 1)	opcional	Número máximo de reintentos automáticos. Una vez alcanzado, el ciclo pasa al estado terminal `exhausted`. p. ej. `3`
`interval_seconds`	integer (≥ 300, ≤ 86400)	opcional	Segundos de espera entre cada reintento. Valores válidos: 300–86400 (5 min a 24h). p. ej. `600`
`outcomes`	array<string> (elementos: 1–?, elementos únicos)	opcional	Resultados que originan un reintento. De forma predeterminada son `not_found`, `cep_unavailable` y `error`; la combinación `["not_found", "cep_unavailable"]` excluye `error`. p. ej. `["not_found","cep_unavailable","error"]`

Petición

cURLPython•JavaScript•PHP•

curl -X PUT 'https://api.veriko.mx/v1/users/me/retry-policy' \
  -H 'Authorization: Bearer veriko_••••' \
  -H 'Content-Type: application/json' \
  -d '{
    "retry_policy": {
      "enabled": false
    }
  }'

Ejemplo en Python — próximamente.

Ejemplo en JavaScript — próximamente.

Ejemplo en PHP — próximamente.

**Respuesta 200**`RetryPolicy` — Política de reintentos actualizada (eco del body normalizado).
Campo	Tipo	Descripción
`enabled`	`boolean`	`true` cuando el ciclo de reintentos está activo. Si es `false`, los demás campos pueden ser ignorados. p. ej. `true`
`max_retries`	`integer`	Número máximo de reintentos automáticos. Una vez alcanzado, el ciclo pasa al estado terminal `exhausted`. p. ej. `3`
`interval_seconds`	`integer`	Segundos de espera entre cada reintento. Valores válidos: 300–86400 (5 min a 24h). p. ej. `600`
`outcomes`	`array` (elementos: 1–?, elementos únicos)	Resultados que originan un reintento. De forma predeterminada son `not_found`, `cep_unavailable` y `error`; la combinación `["not_found", "cep_unavailable"]` excluye `error`. p. ej. `["not_found","cep_unavailable","error"]`

**Códigos de respuesta**`PUT /v1/users/me/retry-policy`
Código	Clase	Descripción	Cuerpo
200	`2xx`	Política de reintentos actualizada (eco del body normalizado).	`RetryPolicy`
400	`4xx`	El cuerpo de la petición está vacío o no es JSON válido.	`ErrorResponse`
401	`4xx`	Se requiere autenticación o las credenciales son inválidas	`ErrorResponse`
413	`4xx`	El cuerpo de la petición supera el tamaño máximo admitido (`body_too_large`).	`ErrorResponse`
422	`4xx`	La política de reintentos es inválida (`retry_policy_invalid`). Causas: campo `enabled` falta o no es booleano; `max_retries` fuera de `[1, max_retries_cap]`; `interval_seconds` fuera de `[min_interval_seconds, max_interval_seconds]`; `outcomes` vacío cuando `enabled=true`; outcome fuera del allowlist (`eligible_outcomes` de la configuración global de reintentos).	`ErrorResponse`

**Cabeceras de respuesta**`200`
Cabecera	Tipo	Descripción
`Idempotent-Replayed`	`string`	Solo presente cuando el cliente envió `Idempotency-Key`. `true` cuando la respuesta es replay del caché de idempotencia (TTL 24h por usuario+endpoint+key).

**Errores de `PUT /v1/users/me/retry-policy`**
Código	Clave	Ejemplo
400	`body_empty`	El cuerpo de la petición está vacío. Envelope meta.request_id `b0c1d2e3f4a5b0c1d2e3f4a5`
400	`invalid_json`	El cuerpo no es JSON válido. Envelope meta.request_id `c1d2e3f4a5b6c1d2e3f4a5b6`
401	`unauthorized`	Credenciales de autenticación ausentes o inválidas. Envelope meta.request_id `c4d5e6f7a8b99b8a7f6e5d4c`
413	`body_too_large`	El cuerpo de la petición es demasiado grande. Envelope meta.request_id `1a2b3c4d5e6ff6e5d4c3b2a1`

Política de reintentos

PUT /v1/users/me/retry-policy

Política de reintentos de una validación: activación, límite, intervalo y resultados elegibles.

Intentos: —
Intervalo: 5 min – 1 h × 24
Resultados elegibles: not_found, cep_unavailable, error

Esta operación admite una política de reintentos opcional.