Autenticación

Cada petición se identifica con un token personal de tu cuenta.

Crear un token

1. Entra en CreaVibe con tu cuenta o crea una gratis.
2. Abre el menú de tu cuenta (tu avatar, arriba a la derecha) y entra en API.
3. Escribe un nombre que lo identifique y pulsa Crear token.
4. Copia el token: empieza por cv_ y solo se muestra una vez.

Enviar el token

Inclúyelo en la cabecera Authorization de cada petición:

Authorization: Bearer cv_TU_TOKEN

Si falta o no es válido, la API responde 401:

{
  "type": "https://creavibe.app/desarrolladores/api/errores/#invalid_token",
  "title": "Unauthorized",
  "status": 401,
  "detail": "The token is not valid or has expired. Create another one in your CreaVibe profile.",
  "code": "invalid_token"
}

Validez y revocación

• Cada token caduca a los 90 días.
• Puedes revocarlo en cualquier momento desde la misma pestaña API; deja de funcionar al instante.
• Puedes tener hasta 3 tokens activos, por ejemplo uno por integración.

Qué permite un token

Un token da acceso al catálogo público y a los proyectos, la biblioteca y los créditos de tu cuenta: exactamente las operaciones de esta referencia (en la especificación OpenAPI, las que admiten TokenAuth). No da acceso a tu perfil, a tus pagos ni a los datos de otras cuentas, y no permite borrar nada. Una petición fuera de ese alcance responde 403 con el código token_not_allowed.

{
  "type": "https://creavibe.app/desarrolladores/api/errores/#token_not_allowed",
  "title": "Forbidden",
  "status": 403,
  "detail": "This operation is not available with an API token.",
  "code": "token_not_allowed"
}

Buenas prácticas

• Trata el token como una contraseña: guárdalo en una variable de entorno o en un gestor de secretos.
• Úsalo solo desde tu servidor; no lo incluyas en código que se ejecute en el navegador ni en un repositorio.
• Si crees que se ha filtrado, revócalo y crea otro.