Exemples

Exemples d’authentification pour l’API Kilo IoT — en-têtes curl REST et gRPC utilisant X-API-Key et X-Organization-Id.

Ces exemples montrent comment s'authentifier. Pour les opérations elles-mêmes, voir la référence de l'API.

Requête REST authentifiée

Remplacez les espaces réservés par votre clé et l'ID de votre organisation :

curl -sS https://api.kiloiot.io/api/v2/devices \
  -H "X-API-Key: $KILO_API_KEY" \
  -H "X-Organization-Id: $KILO_ORG_ID"

GET /api/v2/devices renvoie les appareils que la clé est autorisée à voir (cela nécessite une portée Devices Lecture d'accès). Utilisez les deux mêmes en-têtes pour les autres appels ; consultez la référence de l'API pour le chemin et la portée dont chacun a besoin.

gRPC

gRPC utilise les mêmes en-têtes. Pour les définitions natives de client gRPC, utilisez les matériaux fournis avec votre package sur site ou d'intégration.

Bonne pratique

• Conservez la clé dans une variable d'environnement ou un coffre-fort de secrets — jamais dans l'historique du shell ni dans le contrôle de source.

• Utilisez une clé dédiée par intégration, avec uniquement les portées dont elle a besoin.

• Voir Authentification et clés API pour l'ensemble des recommandations.