Autenticação
Autentique cada requisição com uma chave de API no cabeçalho Authorization.
Criar uma chave
Crie as chaves na sua página de conta. Toda chave começa com dt_live_ e nunca expira sozinha. Você pode ter até 5 chaves ativas.
Uma chave leva uma ou mais de cinco permissões: templates:read, runs:write, runs:read, reference_tables:read e reference_tables:write. Uma chave nova recebe as cinco.
reference_tables:read lista suas tabelas de referência e reference_tables:write substitui as linhas de uma tabela. As chaves criadas antes de essas permissões existirem receberam as duas, então não é preciso criar nada de novo.
Enviar a chave
Envie a chave como token Bearer no cabeçalho Authorization. Não há cookie nem modo de teste:
curl "https://doctransform.xyz/api/v1/templates" \
-H "Authorization: Bearer $DOCTRANSFORM_API_KEY"Desde novembro de 2026, um assistente que você mesmo usa entra com Permitir: adicione o DocTransform lá, clique em Permitir e nenhuma chave entra em jogo, então nada secreto fica em um chat. Um script, ou um assistente sem login, ainda aceita uma chave como cabeçalho. A chave fica em uma variável de ambiente:
Claude Code
claude mcp add --transport http doctransform https://doctransform.xyz/mcp --header 'Authorization: Bearer ${DOCTRANSFORM_API_KEY}'Cursor
{
"mcpServers": {
"doctransform": {
"url": "https://doctransform.xyz/mcp",
"headers": {
"Authorization": "Bearer ${env:DOCTRANSFORM_API_KEY}"
}
}
}
}VS Code
{
"servers": {
"doctransform": {
"type": "http",
"url": "https://doctransform.xyz/mcp",
"headers": {
"Authorization": "Bearer ${env:DOCTRANSFORM_API_KEY}"
}
}
}
}O assistente guarda a chave em seu próprio arquivo de configuração no seu computador. Nunca a adicione com --scope project: esse escopo é salvo em um arquivo que sua equipe envia a um repositório, e a chave iria junto.
Girar ou revogar uma chave
Não há rotação no lugar: crie a chave nova, troque seu script para ela e depois revogue a antiga no mesmo cartão da página de conta.
Mantenha a chave em segredo
Uma requisição sem uma chave válida falha com API_KEY_MISSING, API_KEY_INVALID ou INSUFFICIENT_SCOPE.