DocTransform

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

Atenção Nunca coloque uma chave em um navegador ou um repositório. Uma chave é uma credencial de longa duração com acesso total à conta: guarde-a em uma variável de ambiente ou em um gerenciador de segredos.

Uma requisição sem uma chave válida falha com API_KEY_MISSING, API_KEY_INVALID ou INSUFFICIENT_SCOPE.