Le integrazioni server usano Bearer API key; quelle delegate usano OAuth 2.0 con PKCE tramite HQTools.
Chiavi API
Le chiavi hq_test_ e hq_live_ sono separate per ambiente. Le risorse appartengono all’account, quindi la rotazione non interrompe i Job esistenti.
Authorization: Bearer hq_live_...OAuth
Gli access token sono JWT firmati da HQTools, verificati localmente e associati a consenso revocabile per applicazioni terze.
Scope
I permessi sono granulari per Files, Jobs, Tasks, Workflows, Webhooks, Connections, Usage, Logs, URL firmati e realtime.
Sicurezza delle credenziali
Non distribuire mai un segreto permanente nel browser; usa upload firmati, URL di conversione firmati o token realtime brevi.