Autenticazione
Autentica ogni richiesta con una chiave API nell'intestazione Authorization.
Creare una chiave
Crea le chiavi dalla tua pagina Account. Ogni chiave inizia con dt_live_ e non scade mai da sola. Puoi avere fino a 5 chiavi attive.
Una chiave porta uno o più di cinque permessi: templates:read, runs:write, runs:read, reference_tables:read e reference_tables:write. Una chiave nuova li riceve tutti e cinque.
reference_tables:read elenca le tue tabelle di riferimento e reference_tables:write sostituisce le righe di una tabella. Le chiavi create prima che esistessero questi permessi hanno ricevuto entrambi, quindi non serve ricreare nulla.
Inviare la chiave
Invia la chiave come token Bearer nell’intestazione Authorization. Non ci sono cookie né modalità di prova:
curl "https://doctransform.xyz/api/v1/templates" \
-H "Authorization: Bearer $DOCTRANSFORM_API_KEY"Da novembre 2026, un assistente che usi tu stesso accede con Consenti: aggiungi DocTransform lì, fai clic su Consenti e non entra in gioco nessuna chiave, quindi nulla di segreto resta in una chat. Uno script, o un assistente senza accesso, accetta ancora una chiave come intestazione. La chiave resta in una variabile d’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}"
}
}
}
}L’assistente salva la chiave nel proprio file di configurazione sul tuo computer. Non aggiungerla mai con --scope project: quell’ambito è salvato in un file che il tuo team carica in un repository, e la chiave lo seguirebbe.
Ruotare o revocare una chiave
Non esiste una rotazione sul posto: crea la nuova chiave, sposta il tuo script su di essa, poi revoca la vecchia dalla stessa scheda della pagina Account.
Tieni segreta la chiave
Una richiesta senza una chiave valida fallisce con API_KEY_MISSING, API_KEY_INVALID o INSUFFICIENT_SCOPE.