ConverterHQDevelopers
API v1

Authentification

Clés API, OAuth, scopes, séparation test/production et gestion sûre des identifiants.

Les intégrations serveur utilisent des jetons Bearer; les intégrations déléguées utilisent OAuth 2.0 avec PKCE via HQTools.

Clés API

Les clés hq_test_ et hq_live_ sont séparées par environnement. Les ressources appartiennent au compte, ce qui permet de faire tourner une clé sans perdre l’accès aux Jobs existants.

Authorization
Authorization: Bearer hq_live_...

OAuth

Les jetons d’accès OAuth sont des JWT signés par HQTools, vérifiés localement par ConverterHQ et associés à un consentement révocable pour les applications tierces.

Scopes

Les permissions sont granulaires pour Files, Jobs, Tasks, Workflows, Webhooks, Connections, Usage, Logs, URLs signées et temps réel.

Sécurité des identifiants

Ne placez jamais une clé permanente dans un navigateur. Utilisez les uploads signés, les URLs de conversion signées ou les jetons temps réel à courte durée de vie.