ConverterHQDevelopers
API v1

Autenticação

Chaves de API, OAuth, scopes, isolamento teste/produção e uso seguro de credenciais.

Integrações de servidor usam Bearer API keys; integrações delegadas usam OAuth 2.0 com PKCE via HQTools.

Chaves de API

As chaves hq_test_ e hq_live_ são separadas por ambiente. Recursos pertencem à conta, então a rotação de uma chave não perde Jobs existentes.

Authorization
Authorization: Bearer hq_live_...

OAuth

Access tokens são JWTs assinados pelo HQTools, validados localmente e vinculados a consentimento revogável para apps de terceiros.

Scopes

Permissões são granulares para Files, Jobs, Tasks, Workflows, Webhooks, Connections, Usage, Logs, URLs assinadas e realtime.

Segurança das credenciais

Nunca coloque um segredo permanente no navegador. Use uploads assinados, URLs de conversão assinadas ou tokens realtime de curta duração.