ConverterHQDevelopers
API v1

Authenticatie

API-sleutels, OAuth, scopes, test/live-isolatie en veilig credentialbeheer.

Serverintegraties gebruiken Bearer API keys; gedelegeerde integraties gebruiken OAuth 2.0 met PKCE via HQTools.

API-sleutels

hq_test_ en hq_live_ zijn per omgeving gescheiden. Resources horen bij het account, zodat sleutelrotatie bestaande Jobs niet verbreekt.

Authorization
Authorization: Bearer hq_live_...

OAuth

Access tokens zijn door HQTools ondertekende JWT's, lokaal gevalideerd en bij derde partijen gekoppeld aan intrekbare toestemming.

Scopes

Rechten zijn fijnmazig voor Files, Jobs, Tasks, Workflows, Webhooks, Connections, Usage, Logs, signed URLs en realtime.

Credentialveiligheid

Plaats nooit een permanent geheim in de browser; gebruik signed uploads, signed conversion URLs of kortlevende realtime tokens.