Logo PDFHQ

Dokumenty

DokumentacjaAutomatyzacja i integracje

Przegląd automatyzacji — Zapier, MCP i webhooki

Porównaj prywatne łączniki Zapier, narzędzia MCP delegowane przez OAuth, podpisane webhooki projektów i orkiestrację API REST z wymaganiami wstępnymi i ograniczeniami wdrożenia.

Klucze API po stronie serwera Podpisane przesyłanie danych do magazynu

Wybierz odpowiednią powierzchnię do automatyzacji#

PDFHQ oferuje różne powierzchnie integracyjne zamiast pojedynczego punktu końcowego REST o nazwie Zapier lub MCP. Interfejs API zadań wspomaga przetwarzanie; webhook projektu dostarcza zdarzenia; niepublikowana aplikacja CLI platformy Zapier obejmuje dozwolone operacje REST; MCP udostępnia delegowane narzędzia OAuth dla agentów AI.

Bezpośrednie API: udokumentowane zadania, przesyłanie, sztuczna inteligencja i trasy podpisywania są dostępne po odpowiednich poświadczeniach i uprawnieniach konta. Zapier: źródło jest dostępne w integrations/zapier ale nie ma opublikowanej aplikacji. MPK: istnieje serwer lokalny; hostowany protokół OAuth jest tymczasowy i nie jest certyfikowany jako publiczny. Haki internetowe: źródłowe punkty końcowe istnieją, ale zwracają 503, chyba że operator włączył je po konfiguracji i testowaniu.

Zobacz przegląd integracji wizualnej →

Przykład: zadanie PDF → webhook → automatyzacja#

Najpierw prześlij zadanie PDF należące do projektu, korzystając z normalnego cyklu życia interfejsu API. Subskrybuj ukończone wydarzenie dopiero po aktywowaniu webhooków klienta, szyfrowania i pracownika dostawy w ramach wdrożenia. Przechowuj zwrócony klucz podpisu jeden raz; zweryfikuj dokładny surowy ładunek i odrzuć powtórkę przed uruchomieniem dalszej automatyzacji.

Utwórz prywatną subskrypcję webhooka
# Staging only: project API key stored on your server.
curl -X POST 'https://api.pdfhq.io/v1/webhooks' \
  -H 'x-api-key: YOUR_PROJECT_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"target_url":"https://your-app.example/events/pdfhq","events":["pdf.job.succeeded","ai.job.succeeded"]}'
# The first response includes a one-time HMAC signing secret.
# Verify X-PDFHQ-Webhook-Timestamp and X-PDFHQ-Webhook-Signature: v1=...;
# reject old messages and deduplicate on the event ID.

Ładunek webhooka zawiera metadane, a nie bajty PDF czy podpisane linki do pobierania. Niezależnie pobieraj wszelkie dozwolone wyniki za pośrednictwem uwierzytelnionych interfejsów API PDFHQ. Dostawa odbywa się co najmniej raz, więc konsumenci muszą radzić sobie z duplikatami.

Zdarzenia webhooka, weryfikacja, ponowne próby i powtórka →

Zapier: prywatne źródło aplikacji#

Uwierzytelnianie za pomocą klucza projektu umożliwia wyzwalanie i akcje zadań PDF/AI, z podpisanymi hakami REST dla obsługiwanych zdarzeń projektu i rezerwowym odpytywaniem. Autoryzowany dokument musi już zostać przesłany w ramach zapieczętowanego procesu przesyłania. Aplikacja może przygotowywać jedynie niewysłane wersje robocze podpisów w piaskownicy; nie może wysyłać zaproszeń na żywo.

Weryfikacja offline (przed konfiguracją prywatnego interfejsu CLI Zapier)
cd integrations/zapier
npm install
npm test
npx zapier-platform validate

Przed opublikowaniem czegokolwiek zweryfikuj łącznik za pomocą konta programisty Zapier i tymczasowego interfejsu API. To repozytorium nie zawiera publicznej listy Zapier ani linku do instalacji jednym kliknięciem.

Wyzwalacze, działania i ograniczenia Zapiera →

MCP: delegowany dostęp agenta AI#

MCP wykorzystuje kod autoryzacyjny OAuth HQTools + PKCE i zakresy PDFHQ zweryfikowane przez odbiorców. Nie jest to wariant Zapiera z kluczem API i nie obsługuje webhooków. Lokalne stdio można przetestować za pomocą oddzielnie uzyskanego krótkotrwałego tokena; hosting zdalnego serwera MCP wymaga konfiguracji operatora, PKCE i akceptacji cyklu życia.

Cel zdalnego wdrożenia MCP — a nie żądanie połączenia na żywo
https://mcp.pdfhq.io/mcp

Dozwolone narzędzia obejmują status/przesłanie zadań w formacie PDF, oferty/zadania AI i ograniczony status podpisywania. Redakcja, usuwanie, wysyłanie podpisów na żywo i administrowanie danymi uwierzytelniającymi są celowo wyłączone z narzędzi autonomicznych. Wykonywanie sztucznej inteligencji jest kontynuowane zgodnie z regułami kredytu i zgody HQTools.

Zakresy OAuth MCP i konfiguracja staging →

Inne systemy przepływu pracy#

Złącza Native Make i n8n nie są zaimplementowane ani opublikowane. Ich moduły HTTP mogą wywoływać udokumentowane operacje REST, a kompatybilne punkty końcowe HTTPS mogą odbierać webhooki projektu po włączeniu. Nie konfiguruj przepływów pracy w środowisku produkcyjnym, dopóki autoryzacja projektu, podpisy zdarzeń, rozliczenia i ponowne próby nie przejdą połączonych testów.

Kompiluj za pomocą przewodnika szybkiego startu dotyczącego zadania REST →
Logo PDFHQ

Narzędzia PDF i inteligencja dokumentów. Przygotuj, zrozum i pracuj ze swoimi dokumentami.

© 2026 PDFHQ. Wszystkie prawa zastrzeżone.