ConverterHQDevelopers
API v1

Autenticación

Claves API, OAuth, scopes, aislamiento test/live y manejo seguro de credenciales.

Las integraciones de servidor usan Bearer API keys; las integraciones delegadas usan OAuth 2.0 con PKCE mediante HQTools.

Claves API

Las claves hq_test_ y hq_live_ están separadas por entorno. Los recursos pertenecen a la cuenta, por lo que rotar una clave no rompe Jobs existentes.

Authorization
Authorization: Bearer hq_live_...

OAuth

Los access tokens son JWT firmados por HQTools, validados localmente y asociados a consentimiento revocable para aplicaciones de terceros.

Scopes

Los permisos son granulares para Files, Jobs, Tasks, Workflows, Webhooks, Connections, Usage, Logs, URLs firmadas y tiempo real.

Seguridad de credenciales

Nunca distribuyas un secreto permanente al navegador; usa uploads firmados, URLs de conversión firmadas o tokens realtime de corta duración.