Authentification

Jichio utilise deux types de clés. Elles n’ont ni le même format, ni le même en-tête, ni les mêmes droits.

	Clé d’ingestion	Clé API publique
Sert à	Envoyer des événements (SDK)	Lire vos statistiques (scripts, intégrations)
Format	`jch_pr_…`, `jch_st_…`, `jch_sb_…`	`jichio_live_…`
En-tête	`X-API-Key: <clé>`	`Authorization: Bearer <clé>`
Droits	Écriture seule sur `POST /v1/events`	Lecture seule sur `/v1/public/*`
Peut être exposée dans le navigateur	Oui	Non, à garder côté serveur
Limite de débit	120 requêtes/min par clé, 180/min par IP	5 000 requêtes/heure par clé

Clé d’ingestion

Chaque environnement d’un projet a sa propre clé. Le préfixe indique l’environnement :

Préfixe	Environnement
`jch_pr_`	Production
`jch_st_`	Staging
`jch_sb_`	Sandbox

Les événements sont rattachés au projet et à l’environnement de la clé utilisée. Vous n’envoyez jamais de projectId : s’il est présent dans le corps, il est ignoré.

POST /v1/events HTTP/1.1
Host: api.bissa.tech
Content-Type: application/json
X-API-Key: jch_pr_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

Avec le SDK, vous n’écrivez jamais cet en-tête : il est ajouté à partir de l’option apiKey.

Une clé d’ingestion est visible par n’importe quel visiteur de votre site. Ce n’est pas grave : elle permet seulement d’envoyer des événements, jamais de lire vos données. Utilisez la clé de production uniquement en production, pour ne pas mélanger vos données de test avec le trafic réel.

Régénérer une clé d’ingestion

Dans les paramètres du projet, chaque environnement permet de révéler, copier et régénérer sa clé. La régénération invalide immédiatement l’ancienne clé : mettez à jour vos variables d’environnement (NEXT_PUBLIC_ANALYTICS_KEY, réglages WordPress, …) juste après. En attendant, les SDK reçoivent 401 et gardent leurs événements en file locale ; ils les renverront une fois la nouvelle clé déployée.

Clé API publique

Une clé API publique donne accès en lecture à l’API publique.

Créer : dans Paramètres → Clés API. Votre adresse e-mail doit être vérifiée. La clé complète n’est affichée qu’une seule fois : copiez-la immédiatement.
Lister : la liste n’affiche que le début de chaque clé.
Révoquer : une clé révoquée est refusée immédiatement.

curl https://api.bissa.tech/v1/public/account \
  -H "Authorization: Bearer jichio_live_xxxxxxxxxxxxxxxxxxxxxxxx"

L’état de votre quota est renvoyé dans chaque réponse, dans meta.rate_limit (limit, remaining, reset en timestamp Unix).

Erreurs d’authentification

Code	Cause	Que faire
`401`	Clé absente, invalide, régénérée ou révoquée	Vérifier la clé et l’en-tête utilisé
`403`	Clé d’ingestion sans droit d’écriture, ou e-mail du propriétaire non vérifié (API publique)	Vérifier l’e-mail du compte ou recréer la clé
`429`	Limite de débit atteinte	Attendre la durée indiquée par l’en-tête `Retry-After`

​Clé d’ingestion

​Régénérer une clé d’ingestion

​Clé API publique

​Erreurs d’authentification

Clé d’ingestion

Régénérer une clé d’ingestion

Clé API publique

Erreurs d’authentification