Accès API — intégrer les données QAI dans vos outils

L'API publique AirKit QAI vous permet d'intégrer les données de qualité de l'air dans vos propres outils : tableau de bord interne, GTB (Gestion Technique du Bâtiment), GMAO, ou tout autre système tiers.

Prérequis : cette fonctionnalité est disponible selon votre abonnement AirKit. Contactez Aquatycia si vous ne voyez pas l'onglet Clés API dans votre espace client.

1. Gérer vos clés API

Dans le menu AirKit QAI, cliquez sur Accès API.
La page portal/airkit-api.php affiche vos clés API actives.
Cliquez sur Créer une clé, saisissez un libellé descriptif (ex : "Intégration GTB Hall A"), et validez.
Copiez immédiatement la clé affichée : elle commence par ak_ et n'est affichée qu'une seule fois pour des raisons de sécurité.

Important : la clé secrète n'est visible qu'à la création. Si vous la perdez, vous devrez en créer une nouvelle (la clé ancienne peut être révoquée).

2. Utiliser la clé API

Ajoutez la clé dans l'en-tête HTTP de vos requêtes :

Authorization: Bearer ak_VOTRE_CLE_SECRETE

3. Endpoints disponibles

Endpoint	Méthode	Description
`/api/v2/airkit/public/measurements.php`	GET	Mesures récentes ou sur une période
`/api/v2/airkit/public/kits.php`	GET	Informations sur vos kits et pièces
`/api/v2/airkit/public/icone.php`	GET	Scores ICONE par pièce

Exemple : récupérer les mesures des dernières 24h

GET https://mobi.aqy.fr/api/v2/airkit/public/measurements.php?hours=24
Authorization: Bearer ak_VOTRE_CLE_SECRETE

Exemple de réponse

{
  "success": true,
  "kit_id": 1,
  "measurements": [
    {
      "room_name": "Salle 1",
      "measured_at": "2026-05-27T14:30:00",
      "co2_ppm": 892,
      "temperature_c": 22.1,
      "humidity_pct": 48.3
    }
  ]
}

4. Révoquer une clé

Sur la page Accès API, cliquez sur Révoquer en face de la clé à désactiver. La clé est invalidée immédiatement.

5. Limites

Chaque clé donne accès uniquement aux données de votre compte (périmètre customers_id).
Les endpoints sont en lecture seule (scope read).
La date de dernière utilisation est journalisée pour audit.

6. Questions fréquentes

Y a-t-il une limite de taux (rate limit) ? Oui, pour préserver les performances. Contactez Aquatycia pour connaître les limites en vigueur.
Puis-je filtrer par kit spécifique avec une clé ? Oui, lors de la création d'une clé vous pouvez optionnellement la lier à un kit précis. Une clé sans kit donne accès à tous vos kits.