Introduction à l'API

Jichio expose trois interfaces HTTP :

Interface	Pour	Authentification
Ingestion	Envoyer des événements, depuis un SDK ou un serveur	Clé d’ingestion dans `X-API-Key`
API publique	Lire vos statistiques depuis un script ou un outil	Clé API publique en `Authorization: Bearer`
Webhooks	Recevoir des alertes sur votre serveur	Signature HMAC à vérifier

URL de base

https://api.bissa.tech

Tous les chemins sont versionnés : /v1/….

Authentification

Voir Authentification pour choisir et créer la bonne clé.

Format des erreurs

Ingestion : erreurs au format FastAPI.

{ "detail": "Invalid API key" }

Pour une erreur de validation (422), detail est une liste décrivant chaque champ invalide. API publique : enveloppe d’erreur structurée.

{
  "error": {
    "code": "UNAUTHORIZED",
    "message": "Invalid API key",
    "documentation_url": "https://jichio.com/docs/api#unauthorized",
    "request_id": "5b0e6a2c-8f1d-4b7e-9c3a-2d4f6e8a1b0c"
  }
}

`code`	Statut HTTP
`BAD_REQUEST`	`400` (y compris paramètres invalides)
`UNAUTHORIZED`	`401`
`FORBIDDEN`	`403`
`NOT_FOUND`	`404`
`RATE_LIMITED`	`429`
`INTERNAL_ERROR`	`5xx`

Identifiant de requête

Chaque réponse contient l’en-tête X-Request-Id. Communiquez-le au support pour toute question sur une requête précise.

Limites de débit

Interface	Limite	En cas de dépassement
Ingestion	120 requêtes/min par clé, 180/min par IP	`429` avec `Retry-After`
API publique	5 000 requêtes/heure par clé	`429` avec `Retry-After` ; état dans `meta.rate_limit`

​URL de base

​Authentification

​Format des erreurs

​Identifiant de requête

​Limites de débit

URL de base

Authentification

Format des erreurs

Identifiant de requête

Limites de débit