ConverterHQDevelopers
API v1

Uwierzytelnianie

Klucze API, OAuth, scope’y, izolacja test/live i bezpieczne zarządzanie poświadczeniami.

Integracje serwerowe używają Bearer API keys, a delegowane integracje OAuth 2.0 z PKCE przez HQTools.

Klucze API

Klucze hq_test_ i hq_live_ są oddzielone środowiskami. Zasoby należą do konta, więc rotacja klucza nie odcina istniejących Jobs.

Authorization
Authorization: Bearer hq_live_...

OAuth

Access tokeny są JWT podpisanymi przez HQTools, weryfikowanymi lokalnie i dla aplikacji zewnętrznych powiązanymi z odwoływalną zgodą.

Scope’y

Uprawnienia są granularne dla Files, Jobs, Tasks, Workflows, Webhooks, Connections, Usage, Logs, podpisanych URL-i i realtime.

Bezpieczeństwo poświadczeń

Nie umieszczaj trwałego sekretu w przeglądarce; używaj podpisanych uploadów, podpisanych URL-i konwersji lub krótkotrwałych tokenów realtime.