Obtener una API Key

App: Minotaur Sales API
Publicado por: Minotaur Sales
Compatible con: app.minotaursales.io

---

Las API keys se gestionan desde tu cuenta de Minotaur. Puedes generar una key directamente desde la app o mediante la API.

Generar desde la app

La forma más sencilla de crear una API key es directamente desde la app de Minotaur:

1. Inicia sesión en app.minotaursales.io.
2. Ve a Configuración → Conexiones → API Key.
3. Haz clic en Generar.
4. Ingresa un nombre y selecciona un período de expiración (7, 30, 90 o 365 días).
5. Selecciona los permisos que necesita la key.
6. Haz clic en Confirmar. Copia la key — se muestra solo una vez.

Las keys generadas desde la app funcionan de forma idéntica a las creadas mediante la API.

Generar mediante la API

Los endpoints a continuación requieren un token de sesión (Bearer <session_token>).

Crear una key

POST /api/api-key/generate
Authorization: Bearer <session_token>
Content-Type: application/json

{
  "name": "Mi Integración",
  "expiration": 30
}

Valores permitidos para expiration: 7, 30, 90, 365.

Listar keys

GET /api/api-key
Authorization: Bearer <session_token>

Retorna registros de keys, nunca el valor crudo.

Actualizar o rotar una key

PATCH /api/api-key/update/:id
Authorization: Bearer <session_token>
Content-Type: application/json

Puede actualizar name y/o expiration, y emite una key nueva. La key anterior deja de funcionar de inmediato.

Revocar una key

PATCH /api/api-key/revoke/:id
Authorization: Bearer <session_token>

La revocación es permanente y no se puede deshacer.

Notas importantes

• El valor de la key se muestra solo una vez al generar/rotar.
• Guarda las keys en un gestor de secretos.
• Para cambiar permisos, rota la key.