Tokens de API — acceso programático a tu espacio de trabajo

Emite y revoca tokens para pipelines CI/CD, scripts de agencia o agentes de IA que necesiten leer o actualizar tus documentos.

Los tokens de API te permiten llamar a la API de miniterms de forma programática — desde un pipeline de CI/CD, un script de gestión de contenido o un agente de IA que obtiene tus últimos documentos de política. Los tokens autentican las solicitudes a la API REST de miniterms sin usar la contraseña de tu cuenta.

Disponibilidad

El acceso a la API es una función de los planes de pago. La página de tokens de API es visible para todos los usuarios, pero el botón de emisión está bloqueado por una verificación de permisos. Si ves "Acceso a la API no disponible en tu plan actual", mejora tu plan desde id.dekimu.com/billing.

Emitir un token

  1. Ve a Ajustes → Tokens de API.
  2. Haz clic en Emitir nuevo token.
  3. Asigna una etiqueta al token (p. ej., "Pipeline CI", "Script de agencia") — es solo para tu referencia.
  4. Copia el token inmediatamente. miniterms muestra el secreto completo una sola vez; después de navegar a otra página queda enmascarado y no puede recuperarse.

Guarda el token en una variable de entorno o gestor de secretos, no en el código fuente.

Usar un token

Incluye el token como cabecera Bearer en cada solicitud a la API:

Authorization: Bearer mt_live_...

La URL base de la API y los endpoints disponibles están documentados en docs.miniterms.com/api.

Revocar un token

Haz clic en Revocar junto a cualquier token activo en la página Ajustes → Tokens de API. La revocación es inmediata — cualquier solicitud en curso que use ese token fallará a partir de ese momento. Crea un nuevo token si vuelves a necesitar acceso.

Notas de seguridad

  • Cada token está limitado únicamente a tu espacio de trabajo — no puede leer ni escribir en otros espacios de trabajo.
  • Los tokens no caducan automáticamente. Rótalos si sospechas que hay una filtración.
  • Si eliminas tu espacio de trabajo, todos los tokens se revocan automáticamente.