---
sourceDocument: Référence de l’API Xanadu
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/fr-FR/xanadu/api-reference

 Release :

    - xanadu

ft:locale :

    - fr-FR

ft:publication_title :

    - Référence de l’API Xanadu

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# RESTResponseV2 - Inclus, global

# RESTResponseV2 - Inclus, global {#ariaid-title1}

* Rversion finale: Xanadu
* 
* Mis à jour 1 août 2024
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 5 minutes de lecture

L'API RESTResponseV2 fournit des méthodes qui permettent d'utiliser les données retournées par un message REST sortant en code JavaScript.

Un objet RESTResponseV2 est renvoyé par les méthodes RESTMessageV2execute() et executeAsync().

Vous pouvez utiliser cette API dans les applications incluses dans le périmètre ou dans le périmètre global.

Cette API s'exécute dans l'espace de noms `sn_ws` .

## RESTResponseV2 : getAllHeaders() {#ariaid-title2}

Renvoie tous les en-têtes contenus dans la réponse, y compris les en-têtes en double.
{#RRV2-getAllHeaders__table_hyh_l1l_gz__entry__3}

| Nom | Type | Description |
|-|-|-|
| Aucun |   |   |
[Tableau 1. Paramètres]

{#RRV2-getAllHeaders__table_hyh_l1l_gz} {#RRV2-getAllHeaders__table_iyh_l1l_gz__entry__2}

| Type | Description |
|-|-|
| List\<GlideHTTPHeader\> | Liste des en-têtes contenus dans la réponse. Chaque en-tête est représenté sous la forme d'un objet GlideHTTPHeader qui contient le <var class="keyword varname">nom</var> et la <var class="keyword varname">valeur</var> de l'en-tête. |
[Tableau 2. Renvoie]

{#RRV2-getAllHeaders__table_iyh_l1l_gz}  
L'exemple de code de suivi montre comment appeler l'API de table REST, puis répertorie tous les en-têtes trouvés dans la réponse.

    var request = new sn_ws.RESTMessageV2();
    request.setEndpoint('http://<SN_Instance_host>/api/now/table/incident');
    request.setHttpMethod('GET');

    request.setBasicAuth('username', 'password');
    request.setRequestHeader("Accept", "application/json");
    var res = request.execute();
    if (res.getStatusCode() != 200) {
      gs.info('Bad Request');
    }

    var headers = res.getAllHeaders();
    for(var i in headers){
      gs.info(headers[i].name + ': ' + headers[i].value);
    }

En-têtes de réponses

    X-Is-Logged-In: true
    X-Transaction-ID: e3003cb2db8c
    X-Total-Count: 66
    X-Content-Type-Options: nosniff
    Pragma: no-store,no-cache
    Cache-Control: no-cache,no-store,must-revalidate,max-age=-1
    Expires: 0
    Content-Type: application/json;charset=UTF-8
    Date: Fri, 14 May 2021 16:05:10 GMT
    Connection: close
    Server: ServiceNow
    JSESSIONID=5041870726ADADFAB2EE2BF8E7E01596; Path=/; HttpOnly; SameSite=None; Secure
    Set-Cookie: glide_user=; Max-Age=0; Expires=Thu, 01-Jan-1970 00:00:10 GMT; Path=/; HttpOnly; SameSite=None; Secure
    Set-Cookie: glide_user_session=; Max-Age=0; Expires=Thu, 01-Jan-1970 00:00:10 GMT; Path=/; HttpOnly; SameSite=None; Secure
    Set-Cookie: glide_user_route=glide.f1aa2015b3fa5fa8dfe567386cde8fd5; Max-Age=2147483647; Expires=Wed, 01-Jun-2089 19:19:17 GMT; Path=/; HttpOnly; SameSite=None; Secure
    Set-Cookie: glide_session_store=AF003CB2DB8CF8103DD9C39D139619C7; Max-Age=1800; Expires=Fri, 14-May-2021 16:35:10 GMT; Path=/; HttpOnly; SameSite=None; Secure
    Set-Cookie: BIGipServerpool_ddershem=2643023626.45630.0000; path=/; Httponly; Secure; SameSite=None; Secure
    Strict-Transport-Security: max-age=63072000; includeSubDomains

## RESTResponseV2 : getBody() {#ariaid-title3}

Obtient le contenu du corps de la réponse REST.
Utilisez cette fonction lorsque vous souhaitez obtenir le corps de la demande en tant que contenu texte. N'utilisez pas cette méthode lors de l'enregistrement de la réponse en tant que pièce jointe binaire. Si un objet RESTMessageV2 appelé la fonction saveResponseBodyAsAttachment(... ), l'utilisation de getBody() sur l'objet RESTResponseV2 associé provoquera une erreur. Lors de l'enregistrement de la réponse en tant que pièce jointe, si le message REST sortant échoue, appelez getErrorMessage() sur la réponse pour récupérer le contenu du corps.
{#r_RESTResponseV2-getBody__table_vy2_525_jqg__entry__3}

| Nom | Type | Description |
|-|-|-|
| Aucun |   |   |
[Tableau 3. Paramètres]

{#r_RESTResponseV2-getBody__table_vy2_525_jqg} {#r_RESTResponseV2-getBody__table_qpt_3f5_jq__entry__2}

| Type | Description |
|-|-|
| Chaîne | Corps de réponse REST. |
[Tableau 4. Renvoie]

{#r_RESTResponseV2-getBody__table_qpt_3f5_jq}  

    var sm = new sn_ws.RESTMessageV2("Yahoo Finance","get"); //Might throw exception if message doesn't exist or not visible due to scope.
    var response = sm.execute();
    var responseBody = response.getBody();

## RESTResponseV2 - getCookies() {#ariaid-title4}

Renvoie tous les cookies inclus dans la réponse.
{#r_RESTResponseV2-getCookies__table_wcc_nbw_ns__entry__3}

| Nom | Type | Description |
|-|-|-|
| Aucun |   |   |
[Tableau 5. Paramètres]

{#r_RESTResponseV2-getCookies__table_wcc_nbw_ns} {#r_RESTResponseV2-getCookies__table_xcc_nbw_ns__entry__2}

| Type | Description |
|-|-|
| Objet | Tableau de chaînes représentant les cookies. Itérez à travers le tableau pour effectuer des opérations sur chaque cookie. |
[Tableau 6. Renvoie]

{#r_RESTResponseV2-getCookies__table_xcc_nbw_ns}  
Afficher les cookies individuels de la réponse.

    var cookies = response.getCookies();
    for (var i = 0; i < cookies.length; i++) {
      gs.info('cookie: ' + cookies.get(i));
    }

Sortie :

    cookie: JSESSIONID=4135AA97A5D12DA22EF614AA2B0CAFD8.node20; Path=/; Secure; HttpOnly
    cookie: SABASESSIONID=370152970.36895.0000; path=/

## RESTResponseV2 : getErrorCode() {#ariaid-title5}

Obtient le code d'erreur numérique en cas d'erreur au cours de la transaction REST.
Ce code d'erreur est spécifique au , il ne s'agit Now Platformpas d'un code d'erreur HTTP. Fournissez ce code d'erreur si vous avez besoin d'aide de l'assistance clientèle ServiceNow.  
Remarque :  
Pour récupérer le contenu du message d'erreur réel, utilisez la méthode [getBody().](https://servicenow-prod.fluidtopics.net/S3MnNWplFTKC_sUjZYcp6A#r_RESTResponseV2-getBody "Obtient le contenu du corps de la réponse REST.")
{#r_RESTResponseV2-getErrorCode__table_vy2_525_jqh__entry__3}

| Nom | Type | Description |
|-|-|-|
| Aucun |   |   |
[Tableau 7. Paramètres]

{#r_RESTResponseV2-getErrorCode__table_vy2_525_jqh} {#r_RESTResponseV2-getErrorCode__table_qpt_3f5_jq__entry__2}

| Type | Description |
|-|-|
| Numéro | Code d'erreur numérique, tel que 1 pour le délai d'expiration du socket. |
[Tableau 8. Renvoie]

{#r_RESTResponseV2-getErrorCode__table_qpt_3f5_jq}  

    var sm = new sn_ws.RESTMessageV2("Yahoo Finance","get"); //Might throw exception if message doesn't exist or not visible due to scope.
    var response = sm.execute();
    var errorCode = response.getErrorCode();

## RESTResponseV2 : getErrorMessage() {#ariaid-title6}

Obtient le message d'erreur en cas d'erreur au cours de la transaction REST.
{#r_RESTResponseV2-getErrorMessage__table_vy2_525_jqi__entry__3}

| Nom | Type | Description |
|-|-|-|
| Aucun |   |   |
[Tableau 9. Paramètres]

{#r_RESTResponseV2-getErrorMessage__table_vy2_525_jqi} {#r_RESTResponseV2-getErrorMessage__table_qpt_3f5_jq__entry__2}

| Type | Description |
|-|-|
| Chaîne | Message d'erreur. |
[Tableau 10. Renvoie]

{#r_RESTResponseV2-getErrorMessage__table_qpt_3f5_jq}  

    var sm = new sn_ws.RESTMessageV2("Yahoo Finance","get"); //Might throw exception if message doesn't exist or not visible due to scope.
    var response = sm.execute();
    var errorMsg = response.getErrorMessage();

## RESTResponseV2 : getHeader(nom de chaîne) {#ariaid-title7}

Obtient la valeur d'un en-tête spécifié.
{#r_RESTResponseV2-getHeader_S__table_vy2_525_jq__entry__3}

| Nom | Type | Description |
|-|-|-|
| nom | Chaîne | Nom de l'en-tête pour lequel vous souhaitez obtenir la valeur, par exemple Set-Cookie. |
[Tableau 11. Paramètres]

{#r_RESTResponseV2-getHeader_S__table_vy2_525_jq} {#r_RESTResponseV2-getHeader_S__table_qpt_3f5_jq__entry__2}

| Type | Description |
|-|-|
| Chaîne | Valeur de l'en-tête spécifié. |
[Tableau 12. Renvoie]

{#r_RESTResponseV2-getHeader_S__table_qpt_3f5_jq}  

    var sm = new sn_ws.RESTMessageV2("Yahoo Finance","get"); //Might throw exception if message doesn't exist or not visible due to scope.
    var response = sm.execute();
    var headerVal = response.getHeader("Content-Type");

## RESTResponseV2 : getHeaders() {#ariaid-title8}

Obtient tous les en-têtes renvoyés dans la réponse REST et les valeurs associées.
Remarque :  
Si un en-tête est présent plusieurs fois dans la réponse, par exemple un en-tête Set-Cookie, cette fonction renvoie uniquement le dernier des en-têtes en double. Pour renvoyer tous les en-têtes, y compris les doublons, utilisez la fonction getAllHeaders().
{#r_RESTResponseV2-getHeaders__table_vy2_525_jqj__entry__3}

| Nom | Type | Description |
|-|-|-|
| Aucun |   |   |
[Tableau 13. Paramètres]

{#r_RESTResponseV2-getHeaders__table_vy2_525_jqj} {#r_RESTResponseV2-getHeaders__table_qpt_3f5_jq__entry__2}

| Type | Description |
|-|-|
| Objet | Objet qui mappe le nom de chaque en-tête à la valeur associée. |
[Tableau 14. Renvoie]

{#r_RESTResponseV2-getHeaders__table_qpt_3f5_jq}  

    var sm = new sn_ws.RESTMessageV2("Yahoo Finance","get"); //Might throw exception if message doesn't exist or not visible due to scope.
    var response = sm.execute();
    var headers = response.getHeaders();

## RESTResponseV2 : getQueryString() {#ariaid-title9}

Obtient la requête entièrement résolue envoyée au point de terminaison REST.
Cette requête contient l'URL du point de terminaison ainsi que toutes les valeurs affectées aux variables dans le message REST. Utilisez cette méthode uniquement avec des réponses à des demandes directes. Cette méthode n'est pas prise en charge pour les demandes envoyées de manière asynchrone ou les demandes envoyées à l'aide d'un MID Server.
{#r_RESTResponseV2-getQueryString__table_vy2_525_jqk__entry__3}

| Nom | Type | Description |
|-|-|-|
| Aucun |   |   |
[Tableau 15. Paramètres]

{#r_RESTResponseV2-getQueryString__table_vy2_525_jqk} {#r_RESTResponseV2-getQueryString__table_qpt_3f5_jq__entry__2}

| Type | Description |
|-|-|
| Chaîne | Requête entièrement résolue. |
[Tableau 16. Renvoie]

{#r_RESTResponseV2-getQueryString__table_qpt_3f5_jq}  

    var sm = new sn_ws.RESTMessageV2("Yahoo Finance","get"); //Might throw exception if message doesn't exist or not visible due to scope.
    var response = sm.execute();
    var queryString = response.getQueryString();

## RESTResponseV2 : getResponseAttachmentSysid() {#ariaid-title10}

Obtient la valeur sys_id de la pièce jointe créée à partir du contenu du corps de la réponse.
Si l'objet RESTMessageV2 associé à cette réponse appelle la fonction saveResponseBodyAsAttachment(... ), utilisez getResponseAttachmentSysid() pour obtenir la sys_id de l'enregistrement de pièce jointe créé. Utilisez cette fonction lorsque vous souhaitez effectuer des opérations supplémentaires avec le nouvel enregistrement de pièce jointe.
{#r_RRV2-getResponseAttachmentSysid__table_kzq_vd2_vs__entry__3}

| Nom | Type | Description |
|-|-|-|
| Aucun |   |   |
[Tableau 17. Paramètres]

{#r_RRV2-getResponseAttachmentSysid__table_kzq_vd2_vs} {#r_RRV2-getResponseAttachmentSysid__table_lzq_vd2_vs__entry__2}

| Type | Description |
|-|-|
| Chaîne | Sys_id du nouvel enregistrement de pièce jointe. |
[Tableau 18. Renvoie]

{#r_RRV2-getResponseAttachmentSysid__table_lzq_vd2_vs}

## RESTResponseV2 : getStatusCode() {#ariaid-title11}

Obtient le code d'état HTTP numérique renvoyé par le fournisseur REST.
{#r_RESTResponseV2-getStatusCode__table_vy2_525_jql__entry__3}

| Nom | Type | Description |
|-|-|-|
| Aucun |   |   |
[Tableau 19. Paramètres]

{#r_RESTResponseV2-getStatusCode__table_vy2_525_jql} {#r_RESTResponseV2-getStatusCode__table_qpt_3f5_jq__entry__2}

| Type | Description |
|-|-|
| Numéro | Code d'état numérique renvoyé par le fournisseur REST, par exemple 200 pour une réponse réussie. |
[Tableau 20. Renvoie]

{#r_RESTResponseV2-getStatusCode__table_qpt_3f5_jq}  

    var sm = new sn_ws.RESTMessageV2("Yahoo Finance","get"); //Might throw exception if message doesn't exist or not visible due to scope.
    var response = sm.execute();
    var statusCode = response.getStatusCode();

## RESTResponseV2 : haveError() {#ariaid-title12}

Indique si une erreur s'est produite lors de la transaction REST.
{#r_RESTResponseV2-haveError__table_vy2_525_jqm__entry__3}

| Nom | Type | Description |
|-|-|-|
| Aucun |   |   |
[Tableau 21. Paramètres]

{#r_RESTResponseV2-haveError__table_vy2_525_jqm} {#r_RESTResponseV2-haveError__table_qpt_3f5_jq__entry__2}

| Type | Description |
|-|-|
| booléen | Renvoie true s'il y a eu une erreur, false s'il n'y a pas eu d'erreur. |
[Tableau 22. Renvoie]

{#r_RESTResponseV2-haveError__table_qpt_3f5_jq}  

    var sm = new sn_ws.RESTMessageV2("Yahoo Finance","get"); //Might throw exception if message doesn't exist or not visible due to scope.
    var response = sm.execute();
    var error = response.haveError();

## RESTResponseV2 : waitForResponse(Number timeoutSecs) {#ariaid-title13}

Définissez la durée pendant laquelle l'instance attend une réponse du fournisseur de services Web.
Cette méthode remplace la propriété glide.rest.outbound.ecc_response.timeout pour cette réponse REST.
{#r_RESTResponseV2-waitForResponse_N__table_vy2_525_jq__entry__3}

| Nom | Type | Description |
|-|-|-|
| timeoutSecs (en anglais seulement) | Numéro | Durée, en secondes, d'attente de cette réponse. |
[Tableau 23. Paramètres]

{#r_RESTResponseV2-waitForResponse_N__table_vy2_525_jq} {#r_RESTResponseV2-waitForResponse_N__table_nxp_dmh_dr__entry__2}

| Type | Description |
|-|-|
| nul |   |
[Tableau 24. Renvoie]

{#r_RESTResponseV2-waitForResponse_N__table_nxp_dmh_dr}  

    var sm = new sn_ws.RESTMessageV2("Yahoo Finance","get"); //Might throw exception if message doesn't exist or not visible due to scope.
    var response = sm.executeAsync();
    response.waitForResponse(60);