Webhooki i API Airparser

Wysyłaj wyodrębnione dane dokumentów do dowolnego systemu za pomocą webhooków. Powiadomienia w czasie rzeczywistym, bezpośrednie integracje, pełna kontrola dla programistów.

Webhook integration visualization showing real-time data flow

Połącz się z dowolnym systemem

Webhooki pozwalają otrzymywać powiadomienia w czasie rzeczywistym, gdy dokumenty są przetwarzane. Wysyłaj wyodrębnione dane bezpośrednio do swoich niestandardowych aplikacji, systemów wewnętrznych lub dowolnej usługi akceptującej żądania HTTP POST.

Idealne dla programistów, którzy potrzebują pełnej kontroli nad swoimi przepływami pracy przetwarzania dokumentów i chcą zintegrować Airparser z zastrzeżonymi systemami, niestandardowymi bazami danych lub architekturami mikrousług.

Dlaczego warto używać webhooków?

<1s
Dostarczanie w czasie rzeczywistym
100%
Kontrola dla programistów
Dowolny
System lub platforma

Jak to działa

1. Dokument otrzymany

Dokument wysłany do Airparser przez e-mail, przesłanie lub API

2. AI wyodrębnia dane

AI Airparser wyodrębnia ustrukturyzowane dane z dokumentu

3. Webhook uruchomiony

HTTP POST wysłany do Twojego endpointu z danymi JSON

4. Twój system przetwarza

Twoja aplikacja odbiera i przetwarza dane

Jak utworzyć webhook w Airparser

Obejrzyj ten krótki przewodnik dotyczący konfigurowania webhooków w Airparser, aby otrzymywać powiadomienia o danych w czasie rzeczywistym.

Przykład ładunku webhooka

Gdy dokument zostanie przetworzony, Airparser wysyła ładunek JSON na Twój URL webhooka:

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
}

Przypadki użycia webhooków

Niestandardowe bazy danych

Wysyłaj wyodrębnione dane bezpośrednio do swojego PostgreSQL, MySQL, MongoDB lub dowolnego niestandardowego systemu bazodanowego.

Systemy wewnętrzne

Integruj z ERP, CRM lub wewnętrznymi, zastrzeżonymi aplikacjami firmowymi.

Mikrousługi

Uruchamiaj przepływy pracy mikrousług i rozproszone potoki przetwarzania.

Powiadomienia w czasie rzeczywistym

Wysyłaj natychmiastowe alerty do niestandardowych systemów powiadomień, aplikacji mobilnych lub dashboardów.

Analityka i raportowanie

Zasilaj wyodrębnione dane do narzędzi business intelligence i platform analitycznych.

Niestandardowa automatyzacja

Twórz złożone, niestandardowe przepływy pracy automatyzacji dostosowane do Twojej konkretnej logiki biznesowej.

Funkcje webhooków

Bezpieczne dostarczanie

Szyfrowanie HTTPS, opcjonalne podpisy webhooków do weryfikacji, wsparcie dla białej listy IP.

Automatyczne ponowienia

Nieudane dostarczenia webhooków są automatycznie ponawiane z wykładniczym opóźnieniem.

Logi dostarczania

Wyświetlaj szczegółowe logi wszystkich dostarczeń webhooków, odpowiedzi i prób ponowienia.

Tryb testowy

Przetestuj swój endpoint webhooka z przykładowymi danymi przed przetworzeniem rzeczywistych dokumentów.

Niestandardowe nagłówki

Dodawaj niestandardowe nagłówki HTTP dla uwierzytelniania, routowania lub metadanych.

Format JSON

Czyste, ustrukturyzowane ładunki JSON, łatwe do analizy i integracji.

Konfigurowanie webhooków

1

Utwórz swój endpoint webhooka

Skonfiguruj endpoint HTTP w swojej aplikacji, który akceptuje żądania POST. Może to być dowolny serwer WWW, funkcja serverless lub endpoint API.

2

Skonfiguruj w Airparser

Dodaj swój URL webhooka w ustawieniach swojego parsera. Opcjonalnie skonfiguruj niestandardowe nagłówki i uwierzytelnianie.

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

Przetestuj swoją integrację

Użyj funkcji testowej, aby wysłać przykładowy ładunek do swojego endpointu i zweryfikować, czy działa poprawnie.

4

Przetwarzaj przychodzące dane

Analizuj ładunek JSON w swojej aplikacji i przetwarzaj wyodrębnione dane dokumentów zgodnie ze swoją logiką biznesową.

5

Zwróć odpowiedź 200 OK

Twój endpoint musi zwrócić kod stanu 200, aby potwierdzić odbiór. Odpowiedzi inne niż 200 uruchamiają automatyczne ponowienia.

Przykład obsługi webhooka

Prosty przykład Node.js/Express do obsługi webhooków 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');
});

Dostęp do RESTful API

Oprócz webhooków, Airparser oferuje pełne RESTful API do programowego dostępu do wszystkich funkcji.

Prześlij dokumenty

Wysyłaj dokumenty do analizy przez endpointy API

Pobierz wyniki

Uzyskaj wyodrębnione dane za pomocą żądań GET

Zarządzaj parserami

Twórz i konfiguruj parsery programowo

Sprawdź status

Monitoruj status przetwarzania i historię

Często zadawane pytania

Jakie metody HTTP są obsługiwane?

Webhooki używają żądań HTTP POST z ładunkiem JSON. Twój endpoint musi akceptować żądania POST i zwracać kod stanu 2xx.

Jak zabezpieczyć swój endpoint webhooka?

Użyj HTTPS, weryfikuj podpisy webhooków, wdróż białą listę IP lub wymagaj kluczy API w niestandardowych nagłówkach. Airparser obsługuje wszystkie te metody uwierzytelniania.

Co się stanie, jeśli mój endpoint jest niedostępny?

Airparser automatycznie ponawia nieudane dostarczenia do 5 razy z wykładniczym opóźnieniem. Możesz przeglądać wszystkie próby dostarczenia w logach webhooków.

Czy mogę mieć wiele webhooków na parser?

Tak! Skonfiguruj wiele URL-i webhooków, aby jednocześnie wysyłać wyodrębnione dane do różnych systemów.

Czy istnieje limit czasu na dostarczenie webhooków?

Żądania webhooków wygasają po 30 sekundach. Twój endpoint musi szybko odpowiedzieć i przetwarzać dane asynchronicznie w razie potrzeby.

Czy mogę filtrować, które dokumenty uruchamiają webhooki?

Tak! Skonfiguruj warunkowe webhooki na podstawie wartości wyodrębnionych danych, typów dokumentów lub niestandardowych kryteriów.

Co robić, jeśli muszę debugować problemy z webhookami?

Przeglądaj szczegółowe logi dostarczania z danymi żądania/odpowiedzi, czasami i komunikatami błędów. Użyj funkcji testowej, aby wysłać przykładowe ładunki podczas rozwoju.

Twórz niestandardowe integracje z webhookami

Uzyskaj pełną kontrolę dla programistów dzięki webhookom i API Airparser. Bezpłatny okres próbny, karta kredytowa niewymagana.

Gotowy, by rozwijać swoją firmę? Zacznij tutaj.