Type de contenu de la demande et de la réponse de contrôle

  • Rversion finale: Washingtondc
  • Mis à jour 1 févr. 2024
  • 2 minutes de lecture

    • Contrôle les types de contenu autorisés dans les demandes et réponses d’API REST scriptées.

    Par défaut, les API REST basées sur un script prennent en charge application/json, application/xml et texte/xml. Les types de contenu personnalisés définis par l’utilisateur (avec des sous-types JSON ou XML ) sont également pris en charge. Par exemple, application/vnd.collection+json et application/vnd.adobe.xdp+xml sont traitées comme JSON et XML, respectivement.
    Important :
    Si le format du corps de la demande n’est pas de sous-type JSON ou XML , utilisez uniquement le champ DataStream du corps de la demande pour accéder au corps de la demande. L’utilisation des données du corps de la demande, dataString, nextEntry() ou hasNext() avec un format non json ou non-xml entraîne une réponse d’erreur 500 .

    Définition des valeurs par défaut

    Vous pouvez définir les valeurs par défaut de l’API à l’aide des champs Formats de demande pris en charge par défaut et Formats de réponse pris en charge par défaut . Ces champs définissent les valeurs acceptables que les utilisateurs peuvent transmettre dans les en-têtes de demande Content-Type et Accept request, respectivement. Si un utilisateur demandeur spécifie un en-tête Accept ou Content-Type non pris en charge par l’API ou la ressource, l’instance répond avec un code d’erreur HTTP 406 ou 415.

    Vous pouvez remplacer ces valeurs pour chaque ressource à l’aide des formats de demande pris en charge et des formats de réponse pris en charge sur le formulaire Service REST scripté.
    Remarque :
    Le champ Formats de demande pris en charge s’affiche uniquement pour les ressources PUT, POST et PATCH.

    Utilisation de valeurs génériques

    Vous pouvez utiliser des valeurs génériques lorsque vous spécifiez des types de contenu valides.
    • Pour effectuer une recherche par caractères génériques à un seul caractère, utilisez le caractère de pourcentage (%). Ce caractère générique trouve les mots qui contiennent n’importe quel caractère à la place du caractère de signe de pourcentage. Par exemple, pour trouver des mots tels que texte ou test, recherchez : te%t.
    • Pour effectuer une recherche de caractères génériques à plusieurs caractères, utilisez l’astérisque (*). Ce caractère générique trouve les mots qui contiennent zéro ou plusieurs caractères à la place de l’astérisque. Par exemple, pour trouver des mots tels que planifié ou placé, recherchez : pl*d.

    Utilisation du type de contenu x-www-form-urlencoded

    Si une API ou une ressource REST accepte le type de contenu application/x-www-form-urlencoded , vous pouvez récupérer les valeurs urlencoded fournies dans la demande sous forme de carte JSON. Vous pouvez ensuite fournir ces paires clé-valeur urlencoded en tant que paramètres de requête, dans le corps de la requête, ou les deux. Ils sont combinés et stockés dans les paramètres de la demande. Accédez à ces paramètres via l’objet request.queryParams .

    Par exemple, si votre API est définie pour accepter le type de contenu application/x-www-form-urlencoded et que votre API est implémentée comme suit : 
    (function process(/*RESTAPIRequest*/ request, /*RESTAPIResponse*/ response) {

 response.setBody(request.queryParams);

})(request, response);
    ... Ensuite, la requête suivante génère la réponse respective :
    POST to localhost:8080/api/now/some_api/some_resource?name3=value3&name4=value4
    Corps :
    name1=value1&name2=value2
    Réponse :
    { "result":
    { "name4": [ "value4" ], "name3": [ "value3" ], "name2": [ "value2" ],
      "name1": [ "value1" ]
    }
}

    Envoi d’un type binaire dans une réponse

    Lors de l’envoi d’un type binaire dans une réponse, vous devez définir le type de contenu de la réponse et écrire le flux binaire directement à l’aide d’un objet RESTAPIResponseStream . Vous pouvez accéder à cet objet en appelant getStreamWriter() sur l’objet de réponse. Pour plus d'informations, consultez.