Czy istnieje aplikacja AI PaperOffice dla Pipedream?
Nie. Nie ma dedykowanej aplikacji w Pipedream. Korzysta się z kroków kodu w Node.js lub Python, akcji HTTP i wyzwalacza HTTP wobec udokumentowanego interfejsu API REST-API oraz serwera MCP.
Jaki klucz jest wymagany?
Generuje się go w PaperOffice AI w sekcji Konto → API. Dla REST używa się klucza API (poai_) lub tokena użytkownika (po_ut_), dla MCP po_ut_, po_gt_ lub OAuth 2.1. Potwierdzenie adresu e-mail wystarczy. Interfejs API API jest dostępny we wszystkich planach, również w Free.
Jak Pipedream dowiaduje się, że dokument jest gotowy?
Poprzez subskrypcję webhooków, od wersji Professional. Subskrybuje się zdarzenie document.processed przy użyciu URL wyzwalacza HTTP. Przesyłka zawiera pofid, workspace_id, typ dokumentu, key_fields oraz wyeksportowane pola. Dla zadań uruchamianych przez sam workflow należy odpytać GET /job/get/{job_id}.
Jakie zdarzenia może odbierać Pipedream?
document.processed, document.edited, document.deleted, document.version_created, document.note_added, document.tag_added, document.comment_added, document.lifecycle_changed, document.legal_hold_placed oraz document.legal_hold_released. Zakończenie zadania API sprawdza się poprzez job/get.
Jak sprawdzić, że dostarczenie pochodzi od PaperOffice AI?
Każde dostarczenie zawiera nagłówek X-PaperOffice-Signature z sha256= oraz wartością HMAC-SHA256 dla tekstu surowego. Sekret znajduje się w odpowiedzi na subskrypcję. Krok kodu oblicza HMAC i porównuje go, zanim workflow zostanie kontynuowany.
Czy można tworzyć subskrypcje webhooków w aplikacji?
Nie. Subskrypcje webhooków tworzy się za pomocą API z POST /webhooks/subscribe lub poprzez narzędzie MCP po_webhooks_subscribe. Za pomocą POST /webhooks/test wysyła się test.ping do wyzwalacza HTTP.
Czy dostępny jest gotowy kod?
Tak. PaperOffice-AI-Cookbook na GitHub zawiera przepisy w Node.js, Python oraz curl, na licencji MIT. Dokumentacja llms.txt opisuje wszystkie punkty końcowe tak, aby edytor AI mógł wygenerować kod dla Państwa kroku.
Czy istnieją ograniczenia dotyczące liczby wywołań?
Tak. W każdym planie możliwe jest co najmniej 5 wywołań na sekundę, 30 na minutę, 100 na godzinę i 500 na dzień – w taryfie Free per klucz, w płatnych taryfach per konto. Dopóki dostępne są Credits, w płatnych taryfach nie obowiązują limity szybkości (rate-limits). Zapytania o status za pomocą GET /job/get nie są zliczane.
Ile kosztuje jedno wywołanie?
Wywołania rozliczane są w PaperOffice-AI-Credits, minimum 5 Credits za każde rozliczalne wywołanie. Przetwarzanie takie jak OCR lub ekstrakcja faktury jest rozliczane za stronę zgodnie z modelem. Zapytania o job są bezpłatne. Pipedream rozlicza swoje własne Credits osobno.
Gdzie przechowywane są dane?
Dokumenty wysyłane przez Pipedream do PaperOffice AI przetwarzamy w naszym własnym centrum danych w UE. To, co Pipedream przechowuje w zdarzeniach i dziennikach, zależy od konfiguracji Pipedream oraz ustawień Państwa przepływu pracy.