Guías

Cómo funciona el procesamiento asíncrono de documentos y lotes en la API v1 — la máquina de estados encolado/procesando/completado/fallido/cancelado y la cadena de marcas de tiempo created_at/started_at/completed_at.

Registra una URL de callback para recibir una notificación cuando un batch termine, en lugar de hacer polling. Incluye verificación de firma Standard Webhooks, la forma del payload del evento, el comportamiento de reintento, el evento de finalización de bbox y cómo el reprocesamiento de un batch se notifica automáticamente de nuevo.

Use la cabecera Idempotency-Key para reintentar de forma segura las cargas de documentos, el procesamiento por lotes y los disparadores de bbox sin pagar ni ejecutar la misma operación dos veces.

Los endpoints de lista en la API v1 utilizan paginación basada en cursor opaco — no números de página — mediante un next_page_token que usted devuelve textualmente, sin decodificar ni construir por su cuenta.

Cada error de la v1 es un objeto JSON con type, code, message y doc_url. Esta página documenta la taxonomía completa de tipos de error y cada código de error individual, y es exactamente a lo que enlaza un doc_url devuelto.

Los límites de velocidad v1 se aplican por cuenta, no por dirección IP, y cada respuesta incluye las cabeceras X-RateLimit-Limit, X-RateLimit-Remaining y X-RateLimit-Reset para que puedas autorregularte antes de recibir un 429.

bbox es un segundo paso opcional y facturado por separado que localiza exactamente dónde en la página se originó cada valor extraído — coordenadas directas del modelo sin verificación a nivel de píxel, por lo que la precisión debe tratarse como aproximada, no exacta.

v1 lee directamente la configuración de su cuenta en la aplicación web (anotación automática de bbox, política de retención, calidad) en lugar de exponer una capa de configuración de API separada. Esta página explica exactamente qué ajustes sigue siempre la API y cuál le permite anular por solicitud.