Action d'API personnalisée

Adressez une requête HTTP authentifiée à l'API.Netskope

Options

Champ Définition Type Obligatoire

Type de requête

Il s'agit des méthodes de requête HTTP prises en charge, ou verbes HTTP, dans un appel d'API personnalisé. Consultez la section Méthodes de requête HTTP.

  • GET : récupère des données d'un serveur Web en fonction des paramètres. Cette méthode demande une représentation de la ressource spécifiée. Si une requête réussit, un message de réponse 200 (OK) est retourné avec le contenu demandé.

  • POST : Envoie des données à un serveur web en fonction des paramètres, par exemple, charger un fichier. Plusieurs requêtes POST peuvent aboutir à un résultat différent d'un seul POST. Soyez prudent pour éviter d'envoyer plusieurs requêtes POST par inadvertance. Si une requête réussit, un message de réponse 200 (OK) est retourné.

  • PUT : Envoie des données à stocker à un emplacement spécifique sur un serveur web en fonction des paramètres, comme charger un fichier. Contrairement aux requêtes POST, les requêtes PUT sont idempotentes. Pour les requêtes réussies, le résultat d'une seule requête PUT est le même que plusieurs requêtes PUT identiques. Si une requête réussit, un message de réponse 200 (OK), 201 (Created) ou 204 (No Content) est retourné.

  • PATCH : Applique des modifications partielles à une ressource sur un serveur web en fonction des paramètres. PATCH n'est pas idempotente. Plusieurs requêtes PATCH pourraient avoir des conséquences non souhaitées. Si un PATCH réussit, un message de réponse 200 (OK) ou 204 (No Content) est retourné.

  • DELETE : Supprime la ressource spécifiée si elle existe du serveur web en fonction des paramètres. Si une requête DELETE aboutit, un message de réponse200 (OK) est renvoyé.

 Liste déroulante TRUE

Entrée

Champ Définition Type Obligatoire

Requête

URL relative

L'adresse (URL) du serveur Web que vous essayez d'appeler. Spécifiez l'URL relative comme /{insert_remaining_URL}.

Vous pouvez spécifier les paramètres de la requête dans l'URL liée à l'aide de ?, ou en tant que paire clé-valeur dans l'entrée Requête.

Par exemple, pour le point de terminaison de l'API des utilisateurs Netskope, l'URL liée est /api/v2/scim/Users.

 Texte TRUE

Requête

Spécifiez les autres paramètres de la requête à inclure en tant que paires clé-valeur.

Par exemple, {"name":"test"}.

 Objet FALSE

En-têtes

Spécifiez les en-têtes requises en plus de authorization ou content-type, car ce connecteur les gère déjà.

 Objet FALSE

Sortie

Champ Définition Type

Sorties

Code de statut

Le résultat de l'opération. Le connecteur renvoie un code de statut HTTP qui indique si l'action effectuée par la carte a réussi ou échoué.

Pour une liste complète des codes de statut possibles, consultez Codes de statut HTTP.

 Nombre

En-têtes

Contexte détaillé du code de statut, sans lien avec le corps de la sortie. Les en-têtes de réponse dépendent de l'option de requête HTTP sélectionnée. Tous les en-têtes ne sont pas des en-têtes de réponse. Ceci est semblable à {"Content-type":"application/json"}.

Objet

Corps

Les données renvoyées par la requête HTTP que vous avez sélectionnée. Par exemple, les données d'une requête GET.

Objet