Webhooks y API de Airparser
Envía los datos extraídos de documentos a cualquier sistema con webhooks. Notificaciones en tiempo real, integraciones instantáneas, control total para desarrolladores.
Conéctate a cualquier sistema
Los webhooks te permiten recibir notificaciones en tiempo real cuando se procesan los documentos. Envía los datos extraídos directamente a tus aplicaciones personalizadas, sistemas internos o cualquier servicio que acepte solicitudes HTTP POST.
Perfecto para desarrolladores que necesitan control total sobre sus flujos de procesamiento de documentos y quieren integrar Airparser con sistemas propios, bases de datos personalizadas o arquitecturas de microservicios.
¿Por qué usar webhooks?
Cómo funciona
1. Se recibe el documento
El documento se envía a Airparser por e-mail, subida o API
2. La IA extrae los datos
La IA de Airparser extrae datos estructurados del documento
3. Se activa el webhook
Se envía un HTTP POST a tu endpoint con los datos en JSON
4. Tu sistema procesa los datos
Tu aplicación recibe y gestiona los datos
Cómo crear un webhook en Airparser
Mira esta guía rápida sobre cómo configurar webhooks en Airparser para empezar a recibir notificaciones de datos en tiempo real.
Ejemplo de payload de webhook
Cuando se procesa un documento, Airparser envía un payload JSON a la URL de tu webhook:
{
"parser_id": "parser_abc123",
"document_id": "doc_xyz789",
"timestamp": "2024-01-15T10:30:00Z",
"extracted_data": {
"invoice_number": "INV-2024-001",
"invoice_date": "2024-01-10",
"vendor": "Acme Corporation",
"total_amount": 1250.00,
"currency": "USD",
"line_items": [
{
"description": "Professional Services",
"quantity": 10,
"unit_price": 125.00,
"total": 1250.00
}
]
},
"document_url": "https://airparser.com/documents/doc_xyz789",
"confidence": 0.98
}Casos de uso de webhooks
Bases de datos personalizadas
Envía los datos extraídos directamente a tu sistema PostgreSQL, MySQL, MongoDB o cualquier base de datos personalizada.
Sistemas internos
Intégralo con ERP propios, CRM o aplicaciones internas de negocio.
Microservicios
Activa flujos de microservicios y pipelines de procesamiento distribuido.
Notificaciones en tiempo real
Envía alertas instantáneas a sistemas de notificación personalizados, apps móviles o paneles.
Analítica e informes
Alimenta los datos extraídos a herramientas de inteligencia empresarial y plataformas de análisis.
Automatización personalizada
Construye flujos de automatización complejos y personalizados según tu lógica de negocio específica.
Funciones de los webhooks
Entrega segura
Cifrado HTTPS, firmas de webhook opcionales para verificación, soporte de lista blanca de IP.
Reintentos automáticos
Las entregas de webhook fallidas se reintentan automáticamente con backoff exponencial.
Registros de entrega
Consulta registros detallados de todas las entregas de webhook, respuestas e intentos de reintento.
Modo de prueba
Prueba tu endpoint de webhook con datos de ejemplo antes de procesar documentos reales.
Encabezados personalizados
Añade encabezados HTTP personalizados para autenticación, enrutamiento o metadatos.
Formato JSON
Payloads JSON limpios y estructurados, fáciles de analizar e integrar.
Configurar webhooks
Crea tu endpoint de webhook
Configura un endpoint HTTP en tu aplicación que acepte solicitudes POST. Puede ser cualquier servidor web, función serverless o endpoint de API.
Configúralo en Airparser
En la configuración de tu analizador, añade la URL de tu webhook. Opcionalmente, configura encabezados personalizados y autenticación.
https://tudominio.com/webhook/airparserPrueba tu integración
Usa la función de prueba para enviar un payload de ejemplo a tu endpoint y verificar que funciona correctamente.
Gestiona los datos entrantes
Analiza el payload JSON en tu aplicación y procesa los datos del documento extraído según tu lógica de negocio.
Devuelve una respuesta 200 OK
Tu endpoint debe devolver un código de estado 200 para confirmar la recepción. Las respuestas que no sean 200 activan reintentos automáticos.
Ejemplo de gestor de webhook
Ejemplo sencillo en Node.js/Express para gestionar los webhooks de Airparser:
const express = require('express');
const app = express();
app.use(express.json());
app.post('/webhook/airparser', (req, res) => {
const data = req.body;
console.log('Received data:', data.extracted_data);
// Process the extracted data
// e.g., save to database, trigger workflow, etc.
// Return 200 to acknowledge receipt
res.status(200).json({ received: true });
});
app.listen(3000, () => {
console.log('Webhook server running on port 3000');
});Acceso a la API RESTful
Además de los webhooks, Airparser ofrece una completa API RESTful para el acceso programático a todas las funciones.
Subir documentos
Envía documentos para su análisis vía endpoints de API
Recuperar resultados
Obtén los datos extraídos con solicitudes GET
Gestionar analizadores
Crea y configura analizadores mediante programación
Comprobar el estado
Supervisa el estado y el historial de procesamiento
Preguntas frecuentes
¿Qué métodos HTTP se admiten?
Los webhooks usan solicitudes HTTP POST con payloads JSON. Tu endpoint debe aceptar solicitudes POST y devolver un código de estado 2xx.
¿Cómo aseguro mi endpoint de webhook?
Usa HTTPS, verifica las firmas de webhook, implementa una lista blanca de IP o exige claves API en encabezados personalizados. Airparser admite todos estos métodos de autenticación.
¿Qué pasa si mi endpoint está caído?
Airparser reintentará automáticamente las entregas fallidas hasta 5 veces con backoff exponencial. Puedes ver todos los intentos de entrega en los registros de webhook.
¿Puedo tener varios webhooks por analizador?
¡Sí! Configura varias URL de webhook para enviar los datos extraídos a distintos sistemas simultáneamente.
¿Hay un tiempo de espera para la entrega de webhooks?
Las solicitudes de webhook expiran a los 30 segundos. Tu endpoint debe responder rápido y procesar los datos de forma asíncrona si es necesario.
¿Puedo filtrar qué documentos activan los webhooks?
¡Sí! Configura webhooks condicionales según los valores de los datos extraídos, tipos de documento o criterios personalizados.
¿Qué hago si necesito depurar problemas de webhook?
Consulta los registros de entrega detallados que muestran datos de solicitud/respuesta, tiempos y mensajes de error. Usa la función de prueba para enviar payloads de ejemplo durante el desarrollo.
Construye integraciones personalizadas con webhooks
Obtén control total para desarrolladores con los webhooks y la API de Airparser. Prueba gratuita, sin tarjeta de crédito.
