Clés API

Overview

Les clés API permettent à des outils et intégrations externes de lire et d'écrire directement des données dans vos applications Bosferi, sans qu'une personne soit connectée. Chaque clé est limitée à une application et à un niveau d'autorisation précis, indépendamment de tout autre paramètre d'accès de votre entreprise.

Générer une clé

1. Allez dans Paramètres → Clés API.
2. Cliquez sur « Générer une nouvelle clé », donnez-lui un nom et choisissez un niveau d'autorisation pour Calendar (lecture seule, ou lecture et modification).
3. Copiez la clé affichée : c'est la seule fois qu'elle est affichée.

Scopes

Les autorisations de chaque clé sont définies explicitement pour chaque application lors de sa création. Elles n'héritent d'aucun autre paramètre de votre entreprise, y compris des autorisations d'accès aux applications de Bosferi AI. Calendar sert d'exemple ci-dessous.

• Lecture : la clé peut lire des données (par exemple, lister et obtenir des événements du calendrier) mais ne peut rien créer, modifier ni supprimer.
• Modification : la clé peut lire et écrire (créer, modifier et supprimer).

Authentifier les requêtes

Envoyez votre clé sous forme de jeton Bearer dans l'en-tête Authorization à chaque requête:

Authorization: Bearer bos_live_k_xxxxxxxx_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

API Agenda

Prenons Calendar comme exemple. Points de terminaison:

curl "https://api.bosferi.com/v1/calendar/events?from=2026-01-01&to=2026-01-31" \
  -H "Authorization: Bearer bos_live_k_xxxxxxxx_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

curl -X POST "https://api.bosferi.com/v1/calendar/events" \
  -H "Authorization: Bearer bos_live_k_xxxxxxxx_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Team standup",
    "start": "2026-01-15T09:00:00",
    "end": "2026-01-15T09:30:00",
    "allDay": false,
    "color": "primary"
  }'

Limites de débit

Chaque clé est limitée à 120 requêtes par minute. Au-delà, les requêtes renvoient un statut 429 avec un en-tête Retry-After.

Révoquer une clé

Révoquez une clé à tout moment depuis Paramètres → Clés API. La révocation est immédiate : toute requête utilisant cette clé est rejetée à partir de ce moment.

Questions fréquentes