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.

Webhook integration visualization showing real-time data flow

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?

<1s
Consegna in tempo reale
100%
Controllo per gli sviluppatori
Qualsiasi
Sistema o piattaforma

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:

JSON
{
  "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

1

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.

2

Configura in Airparser

Aggiungi il tuo URL webhook nelle impostazioni del tuo parser. Configura opzionalmente header personalizzati e autenticazione.

https://tuodominio.com/webhook/airparser
3

Testa la tua integrazione

Usa la funzione di test per inviare un payload di esempio al tuo endpoint e verificare che funzioni correttamente.

4

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.

5

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:

JAVASCRIPT
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.

Pronto a far crescere la tua attività? Inizia da qui.