API publique - Jichio

L’API publique donne un accès en lecture aux données d’un projet. Elle sert à alimenter un tableau de bord interne, un rapport automatique ou un outil tiers.

Authentification

Créez une clé dans Paramètres → Clés API → Clés API publiques, puis envoyez-la en Bearer :

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

Cette clé donne accès à vos statistiques. Gardez-la côté serveur : ne l’intégrez jamais dans un site ou une application mobile.

Une clé est rattachée à un projet. Les statistiques portent sur l’environnement Production s’il est actif, sinon sur le Bac à sable. Il n’est pas encore possible de choisir l’environnement.

Format des réponses

{
  "data": { },
  "meta": {
    "generated_at": "2026-10-12T10:00:00+00:00",
    "api_version": "v1",
    "request_id": "5b0e6a2c-…",
    "rate_limit": { "limit": 5000, "remaining": 4987, "reset": 1791806400 },
    "bot_filter": true
  }
}

meta.rate_limit.reset est un timestamp Unix. meta.bot_filter indique si le trafic des robots connus est exclu. Les erreurs suivent le format décrit dans l’introduction.

Paramètres de période

/stats et /pages acceptent :

Paramètre	Format	Défaut
`from`	Date ISO 8601	Il y a 30 jours
`to`	Date ISO 8601	Maintenant

La période est limitée à 366 jours. Une période invalide renvoie 400.

Endpoints

`GET /v1/public/account`

Le compte propriétaire du projet.

{ "data": { "id": "…", "email": "you@example.com", "plan": "pro", "subscription_status": "active" } }

subscription_status vaut "none" pour le plan Starter, "active" sinon.

`GET /v1/public/account/usage`

La consommation du mois en cours.

{
  "data": {
    "period": "2026-10",
    "events_used": 42150,
    "limit": 100000,
    "remaining": 57850,
    "unlimited": false,
    "per_environment": [{ "environment": "production", "events_used": 41000 }],
    "api_requests_last_24h": 312,
    "resets_at": "2026-11-01T00:00:00+00:00"
  }
}

`GET /v1/public/sites`

La liste des sites accessibles avec la clé. Elle contient un seul élément : le projet de la clé.

{
  "data": [
    {
      "id": "3f6c…",
      "name": "Mon site",
      "website_url": "https://www.example.com",
      "tracking_verified": true,
      "integration_type": "nextjs",
      "health": { "is_online": true, "http_status": 200, "response_time_ms": 182, "checked_at": "2026-10-12T09:30:00+00:00" }
    }
  ]
}

`GET /v1/public/sites/{site_id}`

Un site. Renvoie 404 si site_id n’est pas le projet de la clé.

`GET /v1/public/sites/{site_id}/stats`

Les indicateurs principaux sur la période. Les robots connus sont exclus.

{
  "data": {
    "page_views": 18234,
    "sessions": 6120,
    "unique_visitors": 4877,
    "bounce_rate": 41.2,
    "avg_time_on_page": 63,
    "conversions": 0
  }
}

Champ	Définition
`avg_time_on_page`	Secondes, plafonné à 1 800
`conversions`	Pas encore calculé : vaut toujours `0`

`GET /v1/public/sites/{site_id}/pages`

Les pages du site sur la période. Paramètre supplémentaire : limit, de 1 à 500, 100 par défaut.

{
  "data": [
    {
      "path": "/pricing",
      "title": "Pricing",
      "pageviews": 3120,
      "uniques": 2410,
      "avgTimeMs": 48000,
      "bounceRate": 38.5,
      "entryRate": 22.1,
      "exitRate": 30.4
    }
  ]
}

Les champs de cet endpoint sont en camelCase, contrairement aux autres. Malgré meta.bot_filter: true, le trafic des robots n’y est pas encore exclu.

​Authentification

​Format des réponses

​Paramètres de période

​Endpoints

​GET /v1/public/account

​GET /v1/public/account/usage

​GET /v1/public/sites

​GET /v1/public/sites/{site_id}

​GET /v1/public/sites/{site_id}/stats

​GET /v1/public/sites/{site_id}/pages

Authentification

Format des réponses

Paramètres de période

Endpoints

`GET /v1/public/account`

`GET /v1/public/account/usage`

`GET /v1/public/sites`

`GET /v1/public/sites/{site_id}`

`GET /v1/public/sites/{site_id}/stats`

`GET /v1/public/sites/{site_id}/pages`