Autenticación (API Key)

La API usa una API Key personal. No hay registro de aplicaciones, redirecciones ni pantallas de consentimiento: la key es tu cuenta.

Generar tu API Key

1. En el Hub, ve a Configuración → API Keys.
2. Haz clic en Generar API key y, si quieres, ponle un nombre (por ejemplo, el de la plataforma que la va a usar).
3. Copia la key en ese momento. Solo se muestra una vez; guardamos únicamente un hash, así que no la podemos recuperar después. Si la pierdes, genera una nueva.

Las keys empiezan por sk_. En el Hub verás solo su prefijo para identificarlas.

Usar la key

Envíala en el header Authorization de cada request:

Authorization: Bearer sk_<tu-api-key>

Ejemplo:

curl https://hub.grou.com/api/ext/me \
  -H "Authorization: Bearer sk_<tu-api-key>"

• La key identifica al mentor: nunca envíes tu id de mentor ni de workspace en el body. Todo lo que crees queda a nombre del dueño de la key.
• Hoy cada key tiene acceso completo a la API de tu cuenta.

Verificar a quién pertenece la key

GET /me devuelve la cuenta a la que corresponde la key. Es útil para comprobar la configuración (o para que un agente de IA confirme en nombre de quién actúa):

{
  "owner_user_id": "6ab8...u001",
  "owner_email": "mentor@ejemplo.com",
  "owner_name": "Ana Pérez",
  "key_id": "6ab8...k001",
  "scopes": ["..."]
}

Revocar una key

En Configuración → API Keys, usa Revocar junto a la key. Deja de funcionar de inmediato (las requests que la usen recibirán 401).

Buenas prácticas

• Trata la key como una contraseña: no la publiques en repositorios, frontends ni capturas de pantalla.
• Úsala solo desde un servidor o desde tu cliente MCP, nunca desde el navegador de tus compradores.
• Usa una key distinta por integración, así puedes revocar una sin afectar a las demás.