Está viendo la documentación de la API v1 (versión anterior). v1 sigue funcionando sin cambios hasta el 31 de enero de 2027, fecha en la que se apagará. Las integraciones nuevas deben usar la API v2, que cubre todo lo de v1 con nombres limpios y paginación por cursor. Si ya integró con v1, la guía de migración lista las equivalencias campo por campo.
Referencia
Buenas prácticas
Sugerencias concretas para que la integración sea estable en producción.
- Guarde el
job_iden su sistema. Es la única forma de rastrear un job después. - Use Idempotency-Key en producción. Te ahorra duplicados ante reintentos por red.
- Comience con keys
test. Cuando todo funcione, genera unalivey cambia el secreto. - Poll cada 5-10s, no menos. Más frecuente solo consume cuota inútilmente.
- Backoff exponencial en errores 5xx. Empiece con 1s, después 2, 4, 8. No martilles.
- Cita
X-Request-Iden cualquier reporte de soporte. Nos deja rastrear su request exacta en los logs.