Définir les paramètres de requêtes disponibles

  • Rversion finale: Xanadu
  • Mis à jour 1 août 2024
  • 1 minute de lecture
  • Définissez les paramètres de requête disponibles pour contrôler les valeurs qu’un utilisateur demandeur peut transmettre dans l’URI de demande.

    Avant de commencer

    Rôle requis : web_service_admin

    Procédure

    1. Accédez à la Tout > Services web du système > API REST basées sur un script.
    2. Sélectionnez un enregistrement d’API REST scripté.
    3. Dans la liste connexe à Paramètres de requête , sélectionnez Nouveau.
    4. Spécifiez le nom du paramètre de requête.
    5. Entrez une description brève et un exemple de valeur pour expliquer comment utiliser le paramètre.
    6. Sélectionnez Soumettre.
    7. Facultatif : Dans l’onglet Paramètres de requête, localisez le paramètre de requête et définissez Est requis sur « vrai » pour documenter ce paramètre de requête comme demandé.
      Remarque :
      Si vous définissez Est obligatoire sur « vrai », le service REST scripté n’applique pas l’exigence du paramètre. Pour imposer l’exigence d’un paramètre de requête, vous devez ajouter une logique à la ressource d’API REST scriptée qui rejette les demandes pour lesquelles les paramètres requis sont manquants.

    Que faire ensuite

    Après avoir défini les paramètres de requête disponibles, associez les paramètres à une ressource REST scriptée. Pour plus de détails, voir Associer des paramètres de requête à une ressource.