Airparser webhooks en API
Stuur geëxtraheerde documentgegevens naar elk systeem met webhooks. Realtime meldingen, directe integraties, volledige controle voor ontwikkelaars.
Verbind met elk systeem
Webhooks laten je realtime meldingen ontvangen wanneer documenten worden verwerkt. Stuur geëxtraheerde gegevens rechtstreeks naar je aangepaste applicaties, interne systemen, of elke service die HTTP POST-verzoeken accepteert.
Perfect voor ontwikkelaars die volledige controle nodig hebben over hun documentverwerkingsworkflows en Airparser willen integreren met eigen systemen, aangepaste databases, of microservicesarchitecturen.
Waarom webhooks gebruiken?
Hoe het werkt
1. Document ontvangen
Document verzonden naar Airparser via e-mail, upload, of API
2. AI extraheert gegevens
Airparser AI extraheert gestructureerde gegevens uit het document
3. Webhook geactiveerd
HTTP POST verzonden naar je eindpunt met JSON-gegevens
4. Je systeem verwerkt
Je applicatie ontvangt en verwerkt de gegevens
Hoe je een webhook maakt in Airparser
Bekijk deze snelle gids over het instellen van webhooks in Airparser om realtime gegevensmeldingen te ontvangen.
Voorbeeld van webhook-payload
Wanneer een document wordt verwerkt, stuurt Airparser een JSON-payload naar je 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
}Use cases voor webhooks
Aangepaste databases
Stuur geëxtraheerde gegevens rechtstreeks naar je PostgreSQL, MySQL, MongoDB, of elk aangepast databasesysteem.
Interne systemen
Integreer met eigen ERP, CRM, of interne zakelijke applicaties.
Microservices
Activeer microservice-workflows en gedistribueerde verwerkingspipelines.
Realtime meldingen
Stuur directe waarschuwingen naar aangepaste meldingssystemen, mobiele apps, of dashboards.
Analyse en rapportage
Voed geëxtraheerde gegevens naar business intelligence-tools en analyseplatforms.
Aangepaste automatisering
Bouw complexe, aangepaste automatiseringsworkflows op maat van jouw specifieke bedrijfslogica.
Webhook-functies
Veilige levering
HTTPS-versleuteling, optionele webhook-handtekeningen voor verificatie, ondersteuning voor IP-whitelisting.
Automatische reintries
Mislukte webhook-leveringen worden automatisch opnieuw geprobeerd met exponentiële backoff.
Leveringslogboeken
Bekijk gedetailleerde logboeken van alle webhook-leveringen, reacties, en retrypogingen.
Testmodus
Test je webhook-eindpunt met voorbeeldgegevens voordat je echte documenten verwerkt.
Aangepaste headers
Voeg aangepaste HTTP-headers toe voor authenticatie, routering, of metadata.
JSON-formaat
Schone, gestructureerde JSON-payloads die eenvoudig te analyseren en integreren zijn.
Webhooks instellen
Maak je webhook-eindpunt aan
Stel een HTTP-eindpunt in je applicatie in dat POST-verzoeken accepteert. Dit kan elke webserver, serverless functie, of API-eindpunt zijn.
Configureer in Airparser
Voeg je webhook-URL toe in je parserinstellingen. Configureer eventueel aangepaste headers en authenticatie.
https://jouwdomein.com/webhook/airparserTest je integratie
Gebruik de testfunctie om een voorbeeldpayload naar je eindpunt te sturen en te verifiëren dat het correct werkt.
Verwerk binnenkomende gegevens
Analyseer de JSON-payload in je applicatie en verwerk de geëxtraheerde documentgegevens volgens je bedrijfslogica.
Retourneer een 200 OK-respons
Je eindpunt moet een 200-statuscode retourneren om ontvangst te bevestigen. Responsen anders dan 200 activeren automatische reintries.
Voorbeeld van webhook-handler
Eenvoudig Node.js/Express-voorbeeld voor het verwerken van 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');
});Toegang tot RESTful API
Naast webhooks biedt Airparser een uitgebreide RESTful API voor programmatische toegang tot alle functies.
Documenten uploaden
Dien documenten in voor analyse via API-eindpunten
Resultaten ophalen
Haal geëxtraheerde gegevens op met GET-verzoeken
Parsers beheren
Maak en configureer parsers programmatisch
Status controleren
Monitor verwerkingsstatus en geschiedenis
Veelgestelde vragen
Welke HTTP-methoden worden ondersteund?
Webhooks gebruiken HTTP POST-verzoeken met JSON-payloads. Je eindpunt moet POST-verzoeken accepteren en een 2xx-statuscode retourneren.
Hoe beveilig ik mijn webhook-eindpunt?
Gebruik HTTPS, verifieer webhook-handtekeningen, implementeer IP-whitelisting, of vereis API-sleutels in aangepaste headers. Airparser ondersteunt al deze authenticatiemethoden.
Wat gebeurt er als mijn eindpunt niet beschikbaar is?
Airparser probeert mislukte leveringen automatisch tot 5 keer opnieuw met exponentiële backoff. Je kunt alle leveringspogingen bekijken in de webhook-logboeken.
Kan ik meerdere webhooks per parser hebben?
Ja! Configureer meerdere webhook-URL's om geëxtraheerde gegevens tegelijkertijd naar verschillende systemen te sturen.
Is er een time-out voor webhook-levering?
Webhook-verzoeken verlopen na 30 seconden. Je eindpunt moet snel reageren en indien nodig gegevens asynchroon verwerken.
Kan ik filteren welke documenten webhooks activeren?
Ja! Stel voorwaardelijke webhooks in op basis van geëxtraheerde gegevenswaarden, documenttypen, of aangepaste criteria.
Wat als ik webhook-problemen moet debuggen?
Bekijk gedetailleerde leveringslogboeken met verzoek-/responsgegevens, timing, en foutmeldingen. Gebruik de testfunctie om voorbeeldpayloads te sturen tijdens de ontwikkeling.
Bouw aangepaste integraties met webhooks
Krijg volledige controle voor ontwikkelaars met Airparser-webhooks en API. Gratis proefperiode, geen creditcard vereist.
