Webhooks et API Airparser
Envoyez les données de documents extraites vers n'importe quel système grâce aux webhooks. Notifications en temps réel, intégrations instantanées, contrôle total pour les développeurs.

Connectez-vous à n'importe quel système
Les webhooks vous permettent de recevoir des notifications en temps réel lorsque des documents sont traités. Envoyez les données extraites directement vers vos applications personnalisées, systèmes internes, ou tout service acceptant les requêtes HTTP POST.
Idéal pour les développeurs qui ont besoin d'un contrôle total sur leurs workflows de traitement documentaire et souhaitent intégrer Airparser à des systèmes propriétaires, des bases de données personnalisées ou des architectures de microservices.
Pourquoi utiliser les webhooks ?
Comment ça marche
1. Document reçu
Le document est envoyé à Airparser par e-mail, envoi ou API
2. L'IA extrait les données
L'IA d'Airparser extrait les données structurées du document
3. Webhook déclenché
Une requête HTTP POST est envoyée à votre endpoint avec les données JSON
4. Votre système traite
Votre application reçoit et traite les données
Comment créer un webhook dans Airparser
Regardez ce guide rapide sur la configuration des webhooks dans Airparser pour commencer à recevoir des notifications de données en temps réel.
Exemple de charge utile webhook
Lorsqu'un document est traité, Airparser envoie une charge utile JSON à votre URL de 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
}Cas d'usage des webhooks
Bases de données personnalisées
Envoyez les données extraites directement vers votre PostgreSQL, MySQL, MongoDB ou tout système de base de données personnalisé.
Systèmes internes
Intégrez avec des ERP, CRM ou applications métier propriétaires.
Microservices
Déclenchez des workflows de microservices et des pipelines de traitement distribués.
Notifications en temps réel
Envoyez des alertes instantanées vers des systèmes de notification personnalisés, applications mobiles ou tableaux de bord.
Analytique et reporting
Alimentez des outils de business intelligence et des plateformes d'analytique avec les données extraites.
Automatisation personnalisée
Créez des workflows d'automatisation complexes et sur mesure adaptés à votre logique métier spécifique.
Fonctionnalités des webhooks
Livraison sécurisée
Chiffrement HTTPS, signatures de webhook optionnelles pour vérification, prise en charge de la liste blanche d'IP.
Nouvelles tentatives automatiques
Les livraisons de webhook échouées sont automatiquement retentées avec un délai exponentiel.
Journaux de livraison
Consultez des journaux détaillés de toutes les livraisons de webhook, réponses et tentatives de nouvel essai.
Mode test
Testez votre endpoint de webhook avec des données d'exemple avant de traiter de vrais documents.
En-têtes personnalisés
Ajoutez des en-têtes HTTP personnalisés pour l'authentification, le routage ou les métadonnées.
Format JSON
Des charges utiles JSON propres et structurées, faciles à analyser et à intégrer.
Configurer les webhooks
Créez votre endpoint de webhook
Configurez un endpoint HTTP dans votre application qui accepte les requêtes POST. Cela peut être n'importe quel serveur web, fonction serverless ou endpoint API.
Configurez dans Airparser
Dans les paramètres de votre parseur, ajoutez votre URL de webhook. Configurez éventuellement des en-têtes personnalisés et une authentification.
https://yourdomain.com/webhook/airparserTestez votre intégration
Utilisez la fonction de test pour envoyer une charge utile d'exemple à votre endpoint et vérifier qu'elle fonctionne correctement.
Traitez les données entrantes
Analysez la charge utile JSON dans votre application et traitez les données du document extrait selon votre logique métier.
Renvoyez une réponse 200 OK
Votre endpoint doit renvoyer un code de statut 200 pour accuser réception. Les réponses non-200 déclenchent des nouvelles tentatives automatiques.
Exemple de gestionnaire de webhook
Exemple simple en Node.js/Express pour gérer les webhooks 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');
});Accès à l'API REST
En plus des webhooks, Airparser fournit une API REST complète pour un accès programmatique à toutes les fonctionnalités.
Envoyer des documents
Soumettez des documents pour analyse via les endpoints de l'API
Récupérer les résultats
Récupérez les données extraites avec des requêtes GET
Gérer les parseurs
Créez et configurez des parseurs par programmation
Vérifier le statut
Surveillez le statut de traitement et l'historique
Questions fréquentes
Quelles méthodes HTTP sont prises en charge ?
Les webhooks utilisent des requêtes HTTP POST avec des charges utiles JSON. Votre endpoint doit accepter les requêtes POST et renvoyer un code de statut 2xx.
Comment sécuriser mon endpoint de webhook ?
Utilisez HTTPS, vérifiez les signatures de webhook, mettez en place une liste blanche d'IP, ou exigez des clés API dans des en-têtes personnalisés. Airparser prend en charge toutes ces méthodes d'authentification.
Que se passe-t-il si mon endpoint est indisponible ?
Airparser retentera automatiquement les livraisons échouées jusqu'à 5 fois avec un délai exponentiel. Vous pouvez consulter toutes les tentatives de livraison dans les journaux de webhook.
Puis-je avoir plusieurs webhooks par parseur ?
Oui ! Configurez plusieurs URL de webhook pour envoyer les données extraites vers différents systèmes simultanément.
Y a-t-il un délai d'expiration pour la livraison des webhooks ?
Les requêtes de webhook expirent après 30 secondes. Votre endpoint doit répondre rapidement et traiter les données de manière asynchrone si nécessaire.
Puis-je filtrer quels documents déclenchent des webhooks ?
Oui ! Configurez des webhooks conditionnels basés sur les valeurs des données extraites, les types de documents ou des critères personnalisés.
Que faire si je dois déboguer des problèmes de webhook ?
Consultez des journaux de livraison détaillés montrant les données de requête/réponse, le timing et les messages d'erreur. Utilisez la fonction de test pour envoyer des charges utiles d'exemple pendant le développement.
Créez des intégrations sur mesure avec les webhooks
Obtenez un contrôle total pour les développeurs avec les webhooks et l'API Airparser. Essai gratuit, sans carte bancaire.