Authentification
Authentifier les requêtes de votre produit vers Beeuni.
Créer un client
Le SDK appelle getToken à chaque requête. Votre application gère le stockage et le renouvellement des 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();Choisir des identifiants
- Utilisez une clé API personnelle pour les scripts serveur ou la CI. Conservez-la sur le serveur et choisissez la portée minimale disponible.
- Utilisez un compte de service pour un agent ou un autre appelant non humain. Attribuez-lui les rôles de projet nécessaires ; un nouveau compte de service n’a accès à aucun projet.
- Pour une application agissant au nom de ses utilisateurs, utilisez Sign in with Beeuni. Le gestionnaire serveur gère les tokens OAuth et leur renouvellement.
Traiter les requêtes refusées
401 indique des identifiants absents, expirés ou invalides. 403 peut indiquer des autorisations insuffisantes ou une fonctionnalité désactivée ; lisez le code d’erreur avant de réessayer.
Si votre fonction de token met en cache un token renouvelable, ajoutez invalidate(rejectedToken). Le SDK appelle cette fonction avant de réessayer une seule fois la requête refusée.
Protéger les identifiants
N’intégrez pas de clés API serveur au code du navigateur, aux URL ou aux logs. Utilisez votre serveur ou le proxy OAuth pour les requêtes du navigateur. Révoquez les identifiants compromis dans Account → Tokens.