Aperçu de l’API REST v2 - Documentation technique Netskope

Les API REST de Netskope utilisent un jeton d'authentification pour effectuer des appels autorisés à l'API. Les API REST de Netskope permettent d'accéder à des ressources via des chemins URI. Le jeton doit être utilisé dans chaque appel à l'API REST pour le locataire. Le jeton peut être créé pour être utilisé avec les API spécifiées dans l'interface utilisateur de Netskope en allant sur Settings > Administration > Administrators & Roles > Administrators et en cliquant sur Service Account. Pour savoir comment créer un jeton New, cliquez ici.

Important

Si votre locataire Netskope est renforcé à l'aide d'IP Allowlist (Settings > Administration > IP Allowlist), assurez-vous d'ajouter les adresses IP source respectives de vos services REST API V2 intégrés à la liste Custom IP.

Documentation de l'API Swagger

Pour voir les informations sur les paramètres de l'API, cliquez sur le lien API Documentation sur la page REST API v2, ce qui ouvre l'interface utilisateur Swagger. Les points de terminaison, les méthodes et les paramètres disponibles sont affichés.

Pour voir les informations sur les charges utiles des points d'extrémité dans Swagger :

Cliquez sur l'un des points de terminaison, comme /api/v2/events/dataexport/alerts/dlp, pour voir les paramètres disponibles et les réponses.
Les descriptions des paramètres fournissent des informations sur les valeurs disponibles, les exigences de format et les facteurs liés à l'utilisation avec d'autres paramètres. Certains paramètres proposent des listes déroulantes pour les options prises en charge, d'autres paramètres utilisent des champs de texte.
Copiez l'URL de la demande de point final et les paramètres à utiliser dans vos appels à l'API. Assurez-vous que le jeton est ajouté à l'en-tête Netskope-API-Token avant d'envoyer des requêtes ; sinon, vous obtiendrez une erreur.