L'API Device Intelligence permet une communication transparente entre les programmes informatiques, ce qui permet l'automatisation et l'intégration avec des applications tierces. Cette section présente une vue d'ensemble des fonctions de l'API disponibles et des directives d'utilisation.
Points d'accès à l'API par région
Utilisez l'URL API appropriée en fonction de votre région :
- US (Oregon): https://api.iotsec.goskope.com
- Germany (Frankfurt): https://api.de.iotsec.goskope.com
Comprendre les URL des API
Une URL d'API se compose de plusieurs éléments, notamment la destination, la version et le point de terminaison de l'API.
https://api.iotsec.goskope.com/v1/integrations/custom_devicecontext
- https://api.iotsec.goskope.com → Destination API
- /v1 → Version de l'API (les versions de l'API peuvent être v1 ou v2, selon la fonctionnalité prise en charge).
- /intégrations/custom_devicecontext → Point final API
Authentification de l'API
L’API Netskope Device Intelligence utilise Basic HTTP Authentication, nécessitant un client_id et secret_key.
Si vos informations d'identification sont incorrectes, l'API renverra l'information :
{
"message": "Unauthorized"
}
Faire des demandes d'API
Vous pouvez interagir avec l'API en utilisant :
- Command Line (cURL):
Utilisez la commande curl pour envoyer des requêtes HTTP et recevoir des réponses :
curl –utilisateur '<client_id>:<secret_key>' https://api.iotsec.goskope.com - API Platforms (e.g., Postman):
Utilisez des outils comme Postman pour envoyer des requêtes GET ou POST. Saisissez l’URL de l’API, définissez le Authorization type sur Basic Auth, et fournissez vos identifiants,client_idetsecret_key.
Réponses de l'API
Toutes les réponses de l'API sont renvoyées dans JSON format.