Autenticación
Autentica las solicitudes de tu producto a Beeuni.
Crear un cliente
El SDK llama a getToken en cada solicitud. Tu aplicación gestiona el almacenamiento y la renovación de tokens.
import { createBeeuni } from '@beeuni/sdk';
const beeuni = createBeeuni({
backendUrl: 'https://api.beeuni.ai/v1',
getToken: async () => process.env.BEEUNI_API_KEY ?? null,
});
const projects = await beeuni.projects.list();Elegir una credencial
- Usa una clave API personal para scripts de servidor o CI. Guárdala en el servidor y elige el ámbito más limitado disponible.
- Usa una cuenta de servicio para un agente u otro llamante no humano. Asigna los roles de proyecto necesarios; una cuenta de servicio nueva no tiene acceso a proyectos.
- Para una aplicación que actúa en nombre de sus usuarios, usa Sign in with Beeuni. El controlador del servidor gestiona los tokens OAuth y su renovación.
Gestionar solicitudes rechazadas
401 indica credenciales ausentes, caducadas o no válidas. 403 puede indicar permisos insuficientes o una función desactivada; lee el código de error antes de reintentar.
Si tu función de token guarda en caché un token rotativo, añade invalidate(rejectedToken). El SDK usa esta función antes de reintentar una vez la solicitud rechazada.
Proteger las credenciales
No incluyas claves API del servidor en código del navegador, URL o registros. Usa tu servidor o el proxy OAuth para solicitudes del navegador. Revoca las credenciales comprometidas en Account → Tokens.