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

 Release :

    - xanadu

ft:locale :

    - de-DE

ft:publication_title :

    - Xanadu-API-Referenz

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# RESTAPIRequest -- Bereichsbezogen, Global

# RESTAPIRequest -- Bereichsbezogen, Global {#ariaid-title1}

* Freigeben Version: Xanadu
* 
* Aktualisiert 1. August 2024
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 2 Minuten Lesedauer

Die RESTAPIRequest- API stellt Methoden bereit, mit denen Sie in Skripts auf geskriptete REST-API-Anforderungsdetails zugreifen können.

Diese API wird im Namespace `sn_ws ausgeführt`.  
Hinweis:  
Sie können Objekte dieses Typs nicht instanziieren. Objekte dieses Typs werden automatisch erstellt und sind nur in Skripts für geskriptete REST-API-Ressourcen verfügbar.

## RESTAPIRequest -- body {#ariaid-title2}

Der Textkörper der Anforderung.
{#r_SSR_body__table_a3m_rt1_sr__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| body | [RESTAPIRequestBody](https://servicenow-prod.fluidtopics.net/17eg4RmAOwFkpWfDzyWNvw#c_ScriptableServiceRequestBody "Die RESTAPIRequestBody- API stellt Methoden bereit, mit denen Sie auf den Textinhalt einer geskripteten REST-API-Anforderung in Skripts zugreifen können.") | Der Textkörper der Anforderung. Sie können über die RESTAPIRequestBody-API auf Daten aus dem body-Objekt zugreifen. |
[Tabelle : 1. Feld]

{#r_SSR_body__table_a3m_rt1_sr}  

    var requestBody = request.body // Returns instance of RESTAPIRequestBody

## RESTAPIRequest -- getHeader(String header) {#ariaid-title3}

Gibt den Wert einer bestimmten Kopfzeile aus der Webservice-Anforderung zurück.
{#r_SSR-getHeader_String__table_q32_q2r_qr__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| header | Zeichenfolge | Der Name des Headers, z. B. accept oder content-type. |
[Tabelle : 2. Parameter]

{#r_SSR-getHeader_String__table_q32_q2r_qr} {#r_SSR-getHeader_String__table_r32_q2r_qr__entry__2}

| Typ | Beschreibung |
|-|-|
| Zeichenfolge | Der Wert der angegebenen Kopfzeile. |
[Tabelle : 3. Ergebnisse]

{#r_SSR-getHeader_String__table_r32_q2r_qr}  

    var acceptHeader = request.getHeader('accept');

## RESTAPIRequest -- getSupportedResponseContentTypes() {#ariaid-title4}

Ruft die Content-Typen ab, die in der Anforderungskopfzeile „Accept" angegeben sind.
{#r_SSR-getSupportedRespContentTypes__table_rtm_qg3_zs__entry__3}

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

{#r_SSR-getSupportedRespContentTypes__table_rtm_qg3_zs} {#r_SSR-getSupportedRespContentTypes__table_stm_qg3_zs__entry__2}

| Typ | Beschreibung |
|-|-|
| Array | Ein Array von Zeichenfolgenwerte, wobei jeder String ein Content-Typ ist, z. B. „application/json". |
[Tabelle : 5. Ergebnisse]

{#r_SSR-getSupportedRespContentTypes__table_stm_qg3_zs}

## RESTAPIRequest -- headers {#ariaid-title5}

Alle Kopfzeilen aus der Anforderung.
{#r_SSR_headers__table_zmm_3s1_sr__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| headers | object | Alle Kopfzeilen der Anforderung und ihre Werte. |
[Tabelle : 6. Feld]

{#r_SSR_headers__table_zmm_3s1_sr}  

    var headers = request.headers; 
    var acceptHeader = headers.Accept;
    var myCustomHeader = headers.myCustom; 
    var specialHeader = headers['special - header'];

## RESTAPIRequest -- pathParams {#ariaid-title6}

Die im Anforderungs-URI übergebenen Pfadparameter.
{#r_SSR_pathParams__table_zsf_jr1_sr__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| pathParams | Objekt | Die Pfadparameter als Skriptobjekt. Die verfügbaren Pfadparameter hängen von der Webservice-Konfiguration ab. |
[Tabelle : 7. Feld]

{#r_SSR_pathParams__table_zsf_jr1_sr}  
In diesem Beispiel hat der geskriptete REST-API-Endpunkt folgendes Format: https://instance.service-now.com/api/now/myservice/{tableName}/{id}. Die verarbeitete Anforderung verwendet diese URL: https://instance.service-now.com/api/now/myservice/myApp_table/1234.

    var pathParams = request.pathParams; 
    var tableName = pathParams.tableName; //'myApp_table' 
    var id = pathParams.id; //'1234'

## RESTAPIRequest - queryParams {#ariaid-title7}

Die Abfrageparameter aus der Webservice-Anforderung.
{#r_SSR_queryParams__table_gzw_yg5_rr__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| queryParams | Array | Die Abfrageparameter aus der Webservice-Anforderung. |
[Tabelle : 8. Feld]

{#r_SSR_queryParams__table_gzw_yg5_rr}  
In diesem Beispiel verwendet die verarbeitete Anforderung diese URL: https://\<instance_rest_endpoint\>?active=false\&name=now. Beachten Sie die Parameter active und name.

    var queryParams = request.queryParams; 
    var isActiveQuery = queryParams.active; // [false] 
    var nameQueryVal = queryParams.name; // ['now']

## RESTAPIRequest -- queryString {#ariaid-title8}

Die gesamte Abfrage, die dem Endpunkt-URI hinzugefügt wurde.
{#r_SSR_queryString__table_zwx_5q1_sr__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| queryString | Zeichenfolge | Die gesamte Abfrage für die Anforderung. |
[Tabelle : 9. Feld]

{#r_SSR_queryString__table_zwx_5q1_sr}  
In diesem Beispiel verwendet die verarbeitete Anforderung diese URL: https://\<instance_rest_endpoint\>?active=false\&name=now. Beachten Sie die Abfrage `active=false&name=now`.

    var query = request.queryString; //"active=false&name=now"

## RESTAPIRequest -- uri {#ariaid-title9}

Der Anforderungs-URI ohne Domäneninformationen.
{#r_SSR_uri__table_h5d_ct1_sr__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| uri | Zeichenfolge | Der Anforderungs-URI ohne Domäneninformationen. |
[Tabelle : 10. Feld]

{#r_SSR_uri__table_h5d_ct1_sr}  
In diesem Beispiel verwendet die verarbeitete Anforderung diese URL: https://instance.service-now.com/api/now/table/myTable?active=false\&name=now.

    var query = request.uri; //"api/now/table/myTable"

## RESTAPIRequest -- url {#ariaid-title10}

Die gesamte Anforderungs-URL.
{#r_SSR_url__table_zdq_qs1_sr__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| URL | Zeichenfolge | Die gesamte Anforderungs-URL. |
[Tabelle : 11. Feld]

{#r_SSR_url__table_zdq_qs1_sr}  
In diesem Beispiel verwendet die verarbeitete Anforderung diese URL: https://instance.service-now.com/api/now/table/myTable?active=false\&name=now.

    var query = request.url; //"https://instance.service-now.com/api/now/table/myTable?active=false&name=now"