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.

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?
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:
{
"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
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.
Skonfiguruj w Airparser
Dodaj swój URL webhooka w ustawieniach swojego parsera. Opcjonalnie skonfiguruj niestandardowe nagłówki i uwierzytelnianie.
https://twojadomena.com/webhook/airparserPrzetestuj swoją integrację
Użyj funkcji testowej, aby wysłać przykładowy ładunek do swojego endpointu i zweryfikować, czy działa poprawnie.
Przetwarzaj przychodzące dane
Analizuj ładunek JSON w swojej aplikacji i przetwarzaj wyodrębnione dane dokumentów zgodnie ze swoją logiką biznesową.
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:
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.