Límites y reintentos
Maneja respuestas 429 sin asumir cuotas numéricas no confirmadas.
No se publica una cuota numérica de solicitudes para esta instancia. Diseña tu integración para responder a 429 y a fallos temporales sin depender de un número fijo de peticiones por minuto.
Reduce la presión
Limita solicitudes concurrentes, agrupa lecturas cuando una operación lo permita y distribuye las consultas de estado en el tiempo. Usa filtros y paginación para evitar descargar repetidamente toda la colección.
Si una respuesta incluye Retry-After, respeta su valor como segundos o fecha HTTP. Si no está presente, utiliza una espera creciente con una pequeña variación aleatoria y un máximo de intentos establecido por tu aplicación.
Reintenta según la operación
| Operación | Antes de repetir |
|---|---|
Consulta GET | Comprueba que el error sea temporal; usa espera entre intentos. |
| Crear sobre, destinatarios o campos | Comprueba si se creó el recurso antes de enviar otra solicitud. |
| Distribuir o redistribuir | Consulta estado y destinatarios para evitar comunicaciones duplicadas. |
| Eliminar o cancelar | Consulta el resultado y confirma la intención del usuario. |
Un fallo de conexión no demuestra que el servidor haya descartado la solicitud. Para escrituras, reconcilia el estado con tu registro local y los recursos de Digito.
Define tiempos de espera y métricas de tu integración: tasa de errores, solicitudes en espera y procesos pendientes. Los límites de paginación indicados en la referencia son parámetros del contrato; no son cuotas de consumo de la API.