Autenticación
Autentica cada petición con una clave de API en la cabecera Authorization.
Crear una clave
Crea las claves desde tu página de cuenta. Toda clave empieza por dt_live_ y no caduca por sí sola. Puedes tener hasta 5 claves activas.
Una clave lleva uno o más de cinco permisos: templates:read, runs:write, runs:read, reference_tables:read y reference_tables:write. Una clave nueva recibe los cinco.
reference_tables:read lista tus tablas de referencia y reference_tables:write reemplaza las filas de una tabla. Las claves que creaste antes de que existieran estos permisos recibieron ambos, así que no hace falta crear nada de nuevo.
Enviar la clave
Envía la clave como token Bearer en la cabecera Authorization. No hay cookie ni modo de prueba:
curl "https://doctransform.xyz/api/v1/templates" \
-H "Authorization: Bearer $DOCTRANSFORM_API_KEY"Desde noviembre de 2026, un asistente que usas tú mismo inicia sesión con Permitir: añade DocTransform allí, haz clic en Permitir y no interviene ninguna clave, así que nada secreto queda en un chat. Un script, o un asistente sin inicio de sesión, sigue tomando una clave como cabecera. La clave se queda en una variable de entorno:
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}"
}
}
}
}El asistente guarda la clave en su propio archivo de configuración en tu ordenador. No la añadas nunca con --scope project: ese ámbito se guarda en un archivo que tu equipo sube a un repositorio, y la clave viajaría con él.
Rotar o revocar una clave
No hay rotación en el sitio: crea la clave nueva, cambia tu script a ella y revoca la antigua desde la misma tarjeta de la página de cuenta.
Mantén la clave en secreto
Una petición sin una clave válida falla con API_KEY_MISSING, API_KEY_INVALID o INSUFFICIENT_SCOPE.