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.

Webhook integration visualization showing real-time data flow

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 ?

<1s
Livraison en temps réel
100 %
Contrôle développeur
Tout
Système ou plateforme

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 :

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
}

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

1

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.

2

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/airparser
3

Testez votre intégration

Utilisez la fonction de test pour envoyer une charge utile d'exemple à votre endpoint et vérifier qu'elle fonctionne correctement.

4

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.

5

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 :

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');
});

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.

Prêt à développer votre activité ? Tout commence ici.