Airparser webhooks & API
Skicka extraherad dokumentdata till alla system med webhooks. Realtidsnotiser, omedelbara integrationer, fullständig utvecklarkontroll.
Anslut till alla system
Webhooks låter dig ta emot realtidsnotiser när dokument bearbetas. Skicka extraherad data direkt till dina anpassade applikationer, interna system eller alla tjänster som accepterar HTTP POST-förfrågningar.
Perfekt för utvecklare som behöver full kontroll över sina dokumentbearbetningsarbetsflöden och vill integrera Airparser med proprietära system, anpassade databaser eller mikrotjänstarkitekturer.
Varför använda webhooks?
Så fungerar det
1. Dokument mottaget
Dokument skickat till Airparser via e-post, uppladdning eller API
2. AI extraherar data
Airparsers AI extraherar strukturerad data från dokumentet
3. Webhook utlöses
HTTP POST skickas till din slutpunkt med JSON-data
4. Ditt system bearbetar
Din applikation tar emot och hanterar datan
Så skapar du en webhook i Airparser
Titta på denna snabbguide om hur du konfigurerar webhooks i Airparser för att börja ta emot realtidsdatanotiser.
Exempel på webhook-nyttolast
När ett dokument bearbetas skickar Airparser en JSON-nyttolast till din webhook-URL:
{
"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
}Användningsfall för webhooks
Anpassade databaser
Skicka extraherad data direkt till din PostgreSQL-, MySQL-, MongoDB- eller alla anpassade databassystem.
Interna system
Integrera med proprietära ERP-, CRM- eller interna affärsapplikationer.
Mikrotjänster
Utlös mikrotjänstarbetsflöden och distribuerade bearbetningspipelines.
Realtidsnotiser
Skicka omedelbara varningar till anpassade notifieringssystem, mobilappar eller instrumentpaneler.
Analys & rapportering
Mata extraherad data till business intelligence-verktyg och analysplattformar.
Anpassad automation
Bygg komplexa, anpassade automationsarbetsflöden skräddarsydda för din specifika affärslogik.
Webhook-funktioner
Säker leverans
HTTPS-kryptering, valfria webhook-signaturer för verifiering, stöd för IP-vitlistning.
Automatiska återförsök
Misslyckade webhook-leveranser görs automatiskt om med exponentiell backoff.
Leveransloggar
Visa detaljerade loggar över alla webhook-leveranser, svar och återförsök.
Testläge
Testa din webhook-slutpunkt med exempeldata innan du bearbetar riktiga dokument.
Anpassade rubriker
Lägg till anpassade HTTP-rubriker för autentisering, routning eller metadata.
JSON-format
Ren, strukturerad JSON-nyttolast som är enkel att analysera och integrera.
Konfigurera webhooks
Skapa din webhook-slutpunkt
Konfigurera en HTTP-slutpunkt i din applikation som accepterar POST-förfrågningar. Detta kan vara vilken webbserver, serverlös funktion eller API-slutpunkt som helst.
Konfigurera i Airparser
Lägg till din webhook-URL i dina parserinställningar. Konfigurera valfritt anpassade rubriker och autentisering.
https://yourdomain.com/webhook/airparserTesta din integration
Använd testfunktionen för att skicka en exempelnyttolast till din slutpunkt och verifiera att den fungerar korrekt.
Hantera inkommande data
Analysera JSON-nyttolasten i din applikation och bearbeta den extraherade dokumentdatan enligt din affärslogik.
Returnera 200 OK-svar
Din slutpunkt bör returnera en 200-statuskod för att bekräfta mottagandet. Icke-200-svar utlöser automatiska återförsök.
Exempel på webhook-hanterare
Enkelt Node.js/Express-exempel för att hantera Airparser webhooks:
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');
});RESTful API-åtkomst
Utöver webhooks tillhandahåller Airparser ett omfattande RESTful API för programmatisk åtkomst till alla funktioner.
Ladda upp dokument
Skicka in dokument för analys via API-slutpunkter
Hämta resultat
Hämta extraherad data med GET-förfrågningar
Hantera parsrar
Skapa och konfigurera parsrar programmatiskt
Kontrollera status
Övervaka bearbetningsstatus och historik
Vanliga frågor
Vilka HTTP-metoder stöds?
Webhooks använder HTTP POST-förfrågningar med JSON-nyttolaster. Din slutpunkt bör acceptera POST-förfrågningar och returnera en 2xx-statuskod.
Hur säkrar jag min webhook-slutpunkt?
Använd HTTPS, verifiera webhook-signaturer, implementera IP-vitlistning eller kräv API-nycklar i anpassade rubriker. Airparser stöder alla dessa autentiseringsmetoder.
Vad händer om min slutpunkt är nere?
Airparser gör automatiskt om misslyckade leveranser upp till 5 gånger med exponentiell backoff. Du kan visa alla leveransförsök i webhook-loggarna.
Kan jag ha flera webhooks per parser?
Ja! Konfigurera flera webhook-URL:er för att skicka extraherad data till olika system samtidigt.
Finns det en timeout för webhook-leverans?
Webhook-förfrågningar timeoutar efter 30 sekunder. Din slutpunkt bör svara snabbt och bearbeta data asynkront vid behov.
Kan jag filtrera vilka dokument som utlöser webhooks?
Ja! Konfigurera villkorsstyrda webhooks baserat på extraherade datavärden, dokumenttyper eller anpassade kriterier.
Vad gör jag om jag behöver felsöka webhook-problem?
Visa detaljerade leveransloggar som visar förfrågnings-/svarsdata, tidpunkt och felmeddelanden. Använd testfunktionen för att skicka exempelnyttolaster under utveckling.
Bygg anpassade integrationer med webhooks
Få full utvecklarkontroll med Airparser webhooks och API. Gratis provperiod, inget kreditkort krävs.
