ConverterHQDevelopers
API v1

Autenticazione

Chiavi API, OAuth, scope, isolamento test/live e gestione sicura delle credenziali.

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
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.