Autenticación: claves de API

La API usa claves de API del workspace, que empiezan con xsk_. Cada clave tiene un nombre, solo vale en el workspace en el que se creó y solo para los alcances que marques.

Crear la claveCopy Anchor Link

1. En XBASE, abre Integraciones y ve a la pestaña Agentes y APIs. Necesitas permiso para gestionar integraciones.
2. En la tarjeta Claves de API, haz clic en Nueva clave (o en Conectar integración, si es la primera).
3. En Nombre, escribe quién va a usar la clave, como "ERP de la tienda".
4. En Permisos, marca solo lo que la integración necesita (alcances).
5. Haz clic en Crear clave. La ventana Clave creada muestra la clave completa una sola vez: cópiala y guárdala en un gestor de contraseñas.
6. Haz clic en Listo, ya la copié.

Usar la claveCopy Anchor Link

Envía la clave en el encabezado Authorization. Para comprobar que funciona, llama a GET /me:

curl https://api.xbase.app/api/external/v1/me \
  -H "Authorization: Bearer $XBASE_API_KEY"

Respuesta 200:

{
  "workspace": { "id": "8f0c2d4e-…", "name": "Mi empresa" },
  "key": { "id": "3b1e9a77-…", "name": "ERP de la tienda", "scopes": ["whatsapp:send"] }
}

Guarda la clave en una variable de entorno o en un gestor de secretos, nunca en el código del sitio o de la aplicación.

Revocar y cambiar la claveCopy Anchor Link

En la tarjeta Claves de API, cada clave aparece con los 4 últimos caracteres, la fecha de creación y el último uso. Haz clic en Revocar para cortar el acceso al instante. Revocar también desactiva el webhook de la clave.

Para cambiar una clave sin detener la integración: crea la nueva, actualiza el sistema que la usa y solo entonces revoca la antigua.

Errores de autenticaciónCopy Anchor Link

Ejemplo:

{
  "statusCode": 401,
  "timestamp": "2026-11-04T16:03:56.074Z",
  "path": "/api/external/v1/me",
  "method": "GET",
  "message": "Chave de API inválida ou revogada.",
  "code": "INVALID_API_KEY"
}

Preguntas frecuentesCopy Anchor Link

Ver tambiénCopy Anchor Link