Resumen de la API
La API v1 de ImageToTable.ai extrae datos estructurados de fotos, escaneos y PDF de documentos reales — facturas, recibos, estados de cuenta, órdenes de compra y similares — y los devuelve como JSON. Esta página presenta los cuatro recursos sobre los que se basa todo lo demás en esta documentación.
Conceptos principales
Cuatro recursos cubren toda la superficie de la API. Cada endpoint en la sección de Referencia opera sobre uno de ellos.
- Documento — una página procesada individual. Se crea subiendo una imagen o una página PDF (la subida de un PDF de varias páginas produce varios documentos, uno por página — consulte la Referencia de documentos). Un documento atraviesa un ciclo de vida de estado (
queued→processing→succeeded/failed/canceled) explicado en detalle en la guía del Modelo de tarea asíncrona. - Lote — un grupo con nombre de documentos que se suben y procesan juntos. Cada documento pertenece exactamente a un lote, identificado por su
batch_name(una cadena que usted elige, o que la API genera automáticamente al subirlo). El procesamiento se inicia, el estado se consulta y los resultados se obtienen a nivel de lote. - Plantilla — un conjunto guardado y reutilizable de campos que desea extraer cada vez (por ejemplo, una plantilla "Factura de proveedor" con
invoice_number,vendor_nameytotal_amount). Las plantillas le permiten evitar declarar los mismos campos en cada llamada aprocess. - Campo — un valor único con nombre que desea extraer de un documento (un número de factura, una fecha, un monto de línea de pedido). Los campos residen en una Plantilla o pueden declararse en línea, de forma puntual, en una sola llamada a
processsin necesidad de crear una Plantilla.
Cómo encajan
Usted sube uno o más archivos a un lote, y cada archivo subido se convierte en un Documento. Luego inicia el procesamiento de ese lote, indicando a la API qué Campos desea recuperar — ya sea señalando una Plantilla guardada, o listando Campos directamente en el cuerpo de la solicitud. Si no especifica ninguno, la API infiere columnas razonables por sí sola. Una vez finalizado el procesamiento, obtiene los resultados del lote: cada Documento devuelve un arreglo line_items de objetos clave-valor por nombre de campo.
JSON es el formato principal
JSON es el formato de respuesta canónico y totalmente compatible para cada endpoint. Las exportaciones a Excel (.xlsx) y Word (.docx) existen como una descarga de conveniencia sobre los mismos datos (consulte Referencia de lotes) — no son un modelo de datos separado, y las integraciones de API deben construirse sobre la estructura JSON.
Autenticación y acceso
Cada solicitud v1 se autentica con una clave de API enviada como Authorization: Bearer <key> — sin respaldo de cookie de sesión, incluso si ha iniciado sesión desde el mismo navegador. La API v1 está disponible para planes de pago (Basic y superiores, incluidos equipos en Growth y superiores); las cuentas del plan gratuito reciben un error plan_required. Consulte Configuración del entorno para saber dónde encontrar su clave.
Próximos pasos
¿Listo para hacer su primera llamada? Inicio rápido le guía para obtener una clave, subir un documento, iniciar el procesamiento y obtener resultados — de principio a fin en unos cinco minutos. Para la lista completa de endpoints, consulte Referencia de API. Si está usando un asistente de codificación con IA para integrar, apúntelo directamente a la especificación OpenAPI 3.1 — es el mismo esquema detrás de cada página de Referencia, legible por máquina de principio a fin.