Webhook e API Airparser
Invia i dati estratti dai documenti a qualsiasi sistema con i webhook. Notifiche in tempo reale, integrazioni dirette, controllo completo per gli sviluppatori.

Collegati a qualsiasi sistema
I webhook ti permettono di ricevere notifiche in tempo reale quando i documenti vengono elaborati. Invia i dati estratti direttamente alle tue applicazioni personalizzate, sistemi interni o qualsiasi servizio che accetta richieste HTTP POST.
Perfetto per gli sviluppatori che hanno bisogno di controllo completo sui loro flussi di lavoro di elaborazione documenti e vogliono integrare Airparser con sistemi proprietari, database personalizzati o architetture a microservizi.
Perché usare i webhook?
Come funziona
1. Documento ricevuto
Documento inviato ad Airparser via email, caricamento o API
2. L'AI estrae i dati
L'AI di Airparser estrae dati strutturati dal documento
3. Webhook attivato
HTTP POST inviato al tuo endpoint con dati JSON
4. Il tuo sistema elabora
La tua applicazione riceve ed elabora i dati
Come creare un webhook in Airparser
Guarda questa rapida guida su come configurare i webhook in Airparser per ricevere notifiche di dati in tempo reale.
Esempio di payload webhook
Quando un documento viene elaborato, Airparser invia un payload JSON al tuo URL 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
}Casi d'uso per i webhook
Database personalizzati
Invia i dati estratti direttamente al tuo PostgreSQL, MySQL, MongoDB o qualsiasi sistema di database personalizzato.
Sistemi interni
Integrati con ERP, CRM o applicazioni aziendali interne proprietarie.
Microservizi
Attiva flussi di lavoro di microservizi e pipeline di elaborazione distribuite.
Notifiche in tempo reale
Invia avvisi immediati a sistemi di notifica personalizzati, app mobili o dashboard.
Analisi e reportistica
Alimenta i dati estratti verso strumenti di business intelligence e piattaforme di analisi.
Automazione personalizzata
Crea flussi di lavoro di automazione complessi e personalizzati su misura per la tua logica di business specifica.
Funzionalità dei webhook
Consegna sicura
Crittografia HTTPS, firme webhook opzionali per la verifica, supporto per whitelist IP.
Retry automatici
Le consegne webhook fallite vengono automaticamente riprovate con backoff esponenziale.
Log di consegna
Visualizza log dettagliati di tutte le consegne webhook, risposte e tentativi di retry.
Modalità di test
Testa il tuo endpoint webhook con dati di esempio prima di elaborare documenti reali.
Header personalizzati
Aggiungi header HTTP personalizzati per autenticazione, routing o metadati.
Formato JSON
Payload JSON puliti e strutturati, facili da analizzare e integrare.
Configurare i webhook
Crea il tuo endpoint webhook
Configura un endpoint HTTP nella tua applicazione che accetta richieste POST. Può essere qualsiasi server web, funzione serverless o endpoint API.
Configura in Airparser
Aggiungi il tuo URL webhook nelle impostazioni del tuo parser. Configura opzionalmente header personalizzati e autenticazione.
https://tuodominio.com/webhook/airparserTesta la tua integrazione
Usa la funzione di test per inviare un payload di esempio al tuo endpoint e verificare che funzioni correttamente.
Elabora i dati in arrivo
Analizza il payload JSON nella tua applicazione ed elabora i dati estratti dai documenti secondo la tua logica di business.
Restituisci una risposta 200 OK
Il tuo endpoint deve restituire un codice di stato 200 per confermare la ricezione. Risposte diverse da 200 attivano retry automatici.
Esempio di gestore webhook
Semplice esempio Node.js/Express per gestire i webhook 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');
});Accesso all'API RESTful
Oltre ai webhook, Airparser offre un'API RESTful completa per l'accesso programmatico a tutte le funzionalità.
Carica documenti
Invia documenti per l'analisi tramite endpoint API
Recupera risultati
Ottieni i dati estratti con richieste GET
Gestisci parser
Crea e configura parser a livello programmatico
Controlla lo stato
Monitora lo stato di elaborazione e la cronologia
Domande frequenti
Quali metodi HTTP sono supportati?
I webhook usano richieste HTTP POST con payload JSON. Il tuo endpoint deve accettare richieste POST e restituire un codice di stato 2xx.
Come proteggo il mio endpoint webhook?
Usa HTTPS, verifica le firme webhook, implementa whitelist IP o richiedi chiavi API in header personalizzati. Airparser supporta tutti questi metodi di autenticazione.
Cosa succede se il mio endpoint non è disponibile?
Airparser riprova automaticamente le consegne fallite fino a 5 volte con backoff esponenziale. Puoi visualizzare tutti i tentativi di consegna nei log dei webhook.
Posso avere più webhook per parser?
Sì! Configura più URL webhook per inviare i dati estratti contemporaneamente a sistemi diversi.
C'è un timeout per la consegna dei webhook?
Le richieste webhook scadono dopo 30 secondi. Il tuo endpoint deve rispondere rapidamente ed elaborare i dati in modo asincrono se necessario.
Posso filtrare quali documenti attivano i webhook?
Sì! Configura webhook condizionali in base ai valori dei dati estratti, tipi di documento o criteri personalizzati.
Cosa faccio se devo eseguire il debug di problemi con i webhook?
Visualizza log di consegna dettagliati con dati di richiesta/risposta, tempistiche e messaggi di errore. Usa la funzione di test per inviare payload di esempio durante lo sviluppo.
Crea integrazioni personalizzate con i webhook
Ottieni il controllo completo per gli sviluppatori con webhook e API Airparser. Prova gratuita, nessuna carta di credito richiesta.