---
sourceDocument: Yokohama-API-Referenz
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/de-DE/yokohama/api-reference

 Release :

    - yokohama

ft:locale :

    - de-DE

ft:publication_title :

    - Yokohama-API-Referenz

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# RESTResponseV2: Bereichsbezogen, global

# RESTResponseV2: Bereichsbezogen, global {#ariaid-title1}

* Freigeben Version: Yokohama
* 
* Aktualisiert 30. Januar 2025
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 5 Minuten Lesedauer

Die RESTResponseV2 Die API bietet Methoden, mit denen Sie die von einer ausgehenden REST-Nachricht zurückgegebenen Daten im JavaScript-Code verwenden können.

Ein RESTResponseV2-Objekt wird von zurückgegeben RESTMessageV2 Methoden Ausführen () Und ExecuteAsync() .

Sie können diese API in bereichsbezogenen Anwendungen oder innerhalb des globalen Bereichs verwenden.

Diese API wird in ausgeführt `sn_WS `Namespace.

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

Gibt alle in der Antwort enthaltenen Header zurück, einschließlich aller doppelten Header.
{#RRV2-getAllHeaders__table_hyh_l1l_gz__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Keine |   |   |
[Tabelle : 1. Parameter]

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

| Typ | Beschreibung |
|-|-|
| List\<GlideHTTPHeader\> | Liste der Header, die in der Antwort enthalten sind. Jeder Header wird als GlideHTTPHeader-Objekt dargestellt, das den Header enthält <var class="keyword varname">Name </var>Und <var class="keyword varname">Wert </var>. |
[Tabelle : 2. Rückgaben]

{#RRV2-getAllHeaders__table_iyh_l1l_gz}  
Das folgende Codebeispiel zeigt, wie die REST-Tabellen-API aufgerufen wird, und listet dann alle in der Antwort gefundenen Header auf.

    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);
    }

Antwort-Header

    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}

Ruft den Inhalt des REST-Antworttexts ab.
Verwenden Sie diese Funktion, wenn Sie den Anforderungstext als Textinhalt abrufen möchten. Verwenden Sie diese Methode nicht, wenn Sie die Antwort als Binäranhang speichern. Wenn ein RESTMessageV2-Objekt genannt wird SaveResponseBodyAsAttachment(...) Funktion, mit GetBody() Verursacht im zugeordneten RESTResponseV2-Objekt einen Fehler. Rufen Sie beim Speichern der Antwort als Anhang an, wenn die ausgehende REST-Nachricht fehlschlägt GetErrorMessage() Auf der Antwort zum Abrufen des Textinhalts.
{#r_RESTResponseV2-getBody__table_vy2_525_jqg__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Keine |   |   |
[Tabelle : 3. Parameter]

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

| Typ | Beschreibung |
|-|-|
| Zeichenfolge | REST-Antworttext. |
[Tabelle : 4. Rückgaben]

{#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}

Gibt alle in der Antwort enthaltenen Cookies zurück.
{#r_RESTResponseV2-getCookies__table_wcc_nbw_ns__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Keine |   |   |
[Tabelle : 5. Parameter]

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

| Typ | Beschreibung |
|-|-|
| Objekt | Array von Zeichenfolgen, die Cookies darstellen. Iterieren Sie durch das Array, um Vorgänge für jedes Cookie auszuführen. |
[Tabelle : 6. Rückgaben]

{#r_RESTResponseV2-getCookies__table_xcc_nbw_ns}  
Zeigen Sie einzelne Cookies aus der Antwort an.

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

Ausgabe:

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

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

Ruft den numerischen Fehlercode ab, wenn während der REST-Transaktion ein Fehler aufgetreten ist.
Dieser Fehlercode ist spezifisch für Now Platform, Ist kein HTTP-Fehlercode. Geben Sie diesen Fehlercode an, wenn Sie Hilfe vom ServiceNow-Kundensupport benötigen.  
Hinweis:  
Um den Inhalt der tatsächlichen Fehlermeldung abzurufen, verwenden Sie [GetBody()](https://servicenow-prod.fluidtopics.net/8e0v0l8Q5SLoAzD~uVObEw#r_RESTResponseV2-getBody "Ruft den Inhalt des REST-Antworttexts ab.")Methode.
{#r_RESTResponseV2-getErrorCode__table_vy2_525_jqh__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Keine |   |   |
[Tabelle : 7. Parameter]

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

| Typ | Beschreibung |
|-|-|
| Nummer | Numerischer Fehlercode, z. B. 1 für Socket-Zeitüberschreitung. |
[Tabelle : 8. Rückgaben]

{#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}

Ruft die Fehlermeldung ab, wenn während der REST-Transaktion ein Fehler aufgetreten ist.
{#r_RESTResponseV2-getErrorMessage__table_vy2_525_jqi__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Keine |   |   |
[Tabelle : 9. Parameter]

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

| Typ | Beschreibung |
|-|-|
| Zeichenfolge | Fehlermeldung. |
[Tabelle : 10. Rückgaben]

{#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 (Zeichenfolgenname) {#ariaid-title7}

Ruft den Wert für einen angegebenen Header ab.
{#r_RESTResponseV2-getHeader_S__table_vy2_525_jq__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| name | Zeichenfolge | Name des Headers, für den Sie den Wert verwenden möchten, z. B. Set-Cookie. |
[Tabelle : 11. Parameter]

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

| Typ | Beschreibung |
|-|-|
| Zeichenfolge | Wert des angegebenen Headers. |
[Tabelle : 12. Rückgaben]

{#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}

Ruft alle in der REST-Antwort zurückgegebenen Header und die zugehörigen Werte ab.
Hinweis:  
Wenn ein Header in der Antwort mehrmals vorhanden ist, z. B. ein Set-Cookie-Header, gibt diese Funktion nur den letzten der doppelten Header zurück. Um alle Header einschließlich Duplikate zurückzugeben, verwenden Sie die GetAllHeader() Funktion.
{#r_RESTResponseV2-getHeaders__table_vy2_525_jqj__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Keine |   |   |
[Tabelle : 13. Parameter]

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

| Typ | Beschreibung |
|-|-|
| Objekt | Objekt, das den Namen jedes Headers dem zugeordneten Wert zuordnet. |
[Tabelle : 14. Rückgaben]

{#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}

Ruft die vollständig aufgelöste Abfrage ab, die an den REST-Endpunkt gesendet wird.
Diese Abfrage enthält die Endpunkt-URL sowie alle Werte, die Variablen in der REST-Nachricht zugewiesen sind. Verwenden Sie diese Methode nur mit Antworten auf direkte Anforderungen. Diese Methode wird für asynchrone oder über einen MID-Server gesendete Anforderungen nicht unterstützt.
{#r_RESTResponseV2-getQueryString__table_vy2_525_jqk__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Keine |   |   |
[Tabelle : 15. Parameter]

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

| Typ | Beschreibung |
|-|-|
| Zeichenfolge | Vollständig aufgelöste Abfrage. |
[Tabelle : 16. Rückgaben]

{#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}

Ruft den sys_ID-Wert des Anhangs ab, der aus dem Inhalt des Antworttexts erstellt wurde.
Wenn das mit dieser Antwort verknüpfte RESTMessageV2-Objekt als bezeichnet wird SaveResponseBodyAsAttachment(...) Funktion, verwenden GetResponseAttachmentSysid() Zum Abrufen der sys_ID des erstellten Anhangsdatensatzes. Verwenden Sie diese Funktion, wenn Sie zusätzliche Vorgänge mit dem neuen Anhangsdatensatz ausführen möchten.
{#r_RRV2-getResponseAttachmentSysid__table_kzq_vd2_vs__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Keine |   |   |
[Tabelle : 17. Parameter]

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

| Typ | Beschreibung |
|-|-|
| Zeichenfolge | SYS_ID des neuen Anhangdatensatzes. |
[Tabelle : 18. Rückgaben]

{#r_RRV2-getResponseAttachmentSysid__table_lzq_vd2_vs}

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

Ruft den numerischen HTTP-Statuscode ab, der vom REST-Provider zurückgegeben wird.
{#r_RESTResponseV2-getStatusCode__table_vy2_525_jql__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Keine |   |   |
[Tabelle : 19. Parameter]

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

| Typ | Beschreibung |
|-|-|
| Nummer | Numerischer Statuscode, der vom REST-Provider zurückgegeben wird, z. B. 200 für eine erfolgreiche Antwort. |
[Tabelle : 20. Rückgaben]

{#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}

Gibt an, ob während der REST-Transaktion ein Fehler aufgetreten ist.
{#r_RESTResponseV2-haveError__table_vy2_525_jqm__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Keine |   |   |
[Tabelle : 21. Parameter]

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

| Typ | Beschreibung |
|-|-|
| boolean | Gibt „wahr" zurück, wenn ein Fehler aufgetreten ist, „falsch", wenn kein Fehler aufgetreten ist. |
[Tabelle : 22. Rückgaben]

{#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}

Legen Sie fest, wie lange die Instanz auf eine Antwort des Webservice Providers wartet.
Diese Methode überschreibt die Eigenschaft „Glide.Rest.outbound.ecc_response.timeout" für diese REST-Antwort.
{#r_RESTResponseV2-waitForResponse_N__table_vy2_525_jq__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| ZeitüberschreitungsSekunden | Nummer | Die Wartezeit in Sekunden für diese Antwort. |
[Tabelle : 23. Parameter]

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

| Typ | Beschreibung |
|-|-|
| Ungültig |   |
[Tabelle : 24. Rückgaben]

{#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);


