---
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


---

# RESTAPIRequestBody -- Umfang, Global

# RESTAPIRequestBody -- Umfang, Global {#ariaid-title1}

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

Die RESTAPIRequestBody Die API bietet Methoden, mit denen Sie in Skripts auf den Textinhalt einer geskripteten REST-API-Anforderung zugreifen können.  
Das Format eines RESTAPIRequestBody-Objekts kann JSON oder XML sein, abhängig vom Headerwert des Inhaltstyps aus der Anforderung.  
Hinweis:  
Sie können keine Objekte dieses Typs instanziieren. Objekte dieses Typs werden automatisch erstellt und sind nur in geskripteten REST-API-Ressourcenskripts zugänglich.

Diese API wird in ausgeführt `sn_WS `Namespace.  
Einzeleintrag-example-Request-body im JSON-Format.

    {
     "name": "user1",
     "id": 1234,
     "roles": [
      {
       "name": "admin"
      },
      {
       "name": "itil"
      }
     ]
    }

Beispiel-Anforderungstext für Mehrfacheinträge im JSON-Format.

    [{
     "name": "user1",
     "id": 1234,
     "roles": [
      {
       "name": "admin"
      },
      {
       "name": "itil"
      }
     ]
    },{
     "name": "user2",
     "id":9876,
     "roles": [
      {
       "name":"admin"
      }
     ]
    }]

## RESTAPIRequestBody: Daten {#ariaid-title2}

Der Inhalt des Anforderungstexts.
Hinweis:  
REST-Webservices verbrauchen Daten, Datastream und dataString über Stream. Da Streams nur einmal verbraucht werden, kann nur einer aufgerufen werden. Wenn Sie beispielsweise sowohl Data als auch dataString aufrufen, wird beim zweiten Aufruf leer zurückgegeben.
{#r_SSRB_data__table_fvt_qv1_sr__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Daten | Objekt oder Array | Der Anforderungsinhalt. Dies kann je nach Anforderung ein einzelnes Objekt oder ein Array von Objekten sein. |
[Tabelle : 1. Feld]

{#r_SSRB_data__table_fvt_qv1_sr}  

    var entry;
    var id;
    var requestBody = request.body;
    var requestData = requestBody.data; //May be an array or a single object
    if (requestData instanceof Array) { 
     entry = requestData[0].name; // 'user1'
     id = requestData[0].id; // '1234'
    } else {
     entry = requestData.name; // 'user1'
     id = requestData.id; // '1234'
    }

## RESTAPIRequestBody: Datenstrom {#ariaid-title3}

Der Inhalt des Anforderungstexts als Stream.
Hinweis:  
REST-Webservices verbrauchen Daten, Datastream und dataString über Stream. Da Streams nur einmal verbraucht werden, kann nur einer aufgerufen werden. Wenn Sie beispielsweise sowohl Data als auch dataString aufrufen, wird beim zweiten Aufruf leer zurückgegeben.
{#r_SSRB_dataStream__table_ycm_sw1_sr__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Datenstrom | Objekt | Der Inhalt des Anforderungstexts. Sie können den Stream an eine separate API übergeben, z. B. um einen Anhang aus der Anforderung zu erstellen oder die Anforderung an einen anderen Endpunkt weiterzuleiten. |
[Tabelle : 2. Feld]

{#r_SSRB_dataStream__table_ycm_sw1_sr}  

    var requestBody = request.body; 
    var requestStream = requestBody.dataStream;

## RESTAPIRequestBody: DataString {#ariaid-title4}

Der Inhalt des Anforderungstexts als Zeichenfolge.
Hinweis:  
REST-Webservices verbrauchen Daten, Datastream und dataString über Stream. Da Streams nur einmal verbraucht werden, kann nur einer aufgerufen werden. Wenn Sie beispielsweise sowohl Data als auch dataString aufrufen, wird beim zweiten Aufruf leer zurückgegeben.
{#r_SSRB_dataString__table_k3m_mw1_sr__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Datenzeichenfolge | Zeichenfolge | Der Inhalt des Anforderungstexts. |
[Tabelle : 3. Feld]

{#r_SSRB_dataString__table_k3m_mw1_sr}  

    var requestBody = request.body; 
    var requestString = requestBody.dataString;

## RESTAPIRequestBody -- hasNext() {#ariaid-title5}

Bestimmt, ob im Anforderungstext zusätzliche Einträge vorhanden sind.
Verwenden Sie diese Methode mit NextEntry() Methode zum Iterieren mehrerer Anforderungstext-Einträge.
{#r_SSRB-hasNext__table_ztm_my1_sr__entry__3}

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

{#r_SSRB-hasNext__table_ztm_my1_sr} {#r_SSRB-hasNext__table_a5m_my1_sr__entry__2}

| Typ | Beschreibung |
|-|-|
| boolean | Kennzeichnung, die angibt, ob im Anforderungstext zusätzliche Einträge vorhanden sind. Mögliche Werte: * Wahr: Zusätzliche Einträge sind verfügbar. As NextEntry() Wird aufgerufen, HasNext() Bleibt so lange bei „wahr", bis der letzte übereinstimmende Datensatz geladen wurde. * Falsch: Keine zusätzlichen Einträge. {#r_SSRB-hasNext__ul_sng_zt5_knb} |
[Tabelle : 5. Rückgaben]

{#r_SSRB-hasNext__table_a5m_my1_sr}  

    var requestBody = request.body;
    requestBody.hasNext(); // returns true if the request contains a single entry or multiple entries
    requestBody. nextEntry(); // returns next available entry

    //calling second time
    requestBody.hasNext(); // returns false if the request contains a single entry, or true if the request contains multiple entries

## RESTAPIRequestBody -- nextEntry() {#ariaid-title6}

Ruft einen Eintrag aus dem Anforderungstext als Skriptobjekt ab.
Verwenden Sie diese Methode mit der hasNext()-Methode, um mehrere Anforderungstext-Einträge zu iterieren.
{#r_SSRB-nextEntry__table_ssb_nx1_sr__entry__3}

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

{#r_SSRB-nextEntry__table_ssb_nx1_sr} {#r_SSRB-nextEntry__table_tsb_nx1_sr__entry__2}

| Typ | Beschreibung |
|-|-|
| Objekt | Ein einzelner Eintrag aus dem Anforderungstext. |
[Tabelle : 7. Rückgaben]

{#r_SSRB-nextEntry__table_tsb_nx1_sr}  

    var requestBody = request.body;
    var requestEntry = requestBody.nextEntry(); // returns available entry if there is only one entry, or the first entry if there are multiple.
    var name = requestEntry.name; // 'user1'

    // Calling second time
    requestEntry = requestBody.nextEntry(); // returns undefined if there is only one entry, or the second entry if there are multiple.

Dieses Beispiel demonstriert die Verwendung von hasNext() mit nextEntry().

    var requestBody = request.body;
    while(requestBody.hasNext()){
    var entry = requestBody.nextEntry();
    }


