---
sourceDocument: Xanadu-API-Referenz
sourceDocumentLink: https://www.servicenow.com/docs/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


---

# GlideHTTPRequest : Global

# GlideHTTPRequest : Global {#ariaid-title1}

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

Die GlideHTTPRequest- API bietet Dienstprogrammmethoden zum Ausführen allgemeiner Funktionen mit Glide-HTTP-Anforderungen.

Sie können diese API in globalen serverseitigen Skripts verwenden. Um diese Klasse zu verwenden, instanziieren Sie ein GlideHTTPRequest-Objekt mithilfe des Konstruktors. Der Konstruktor benötigt eine Endpunkt-URL als Eingabeparameter.

## GlideHTTPRequest -- addHeader(String name, String value) {#ariaid-title2}

Fügt Ihrer HTTP-Anforderung einen Header hinzu.
{#GlideHTTPRequest-addHeader__table_ib1_31z_cfb__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Name | Zeichenfolge | Headername, z. B. `„Akzeptieren"` oder `„Inhaltstyp"`. |
| Wert | Zeichenfolge | Headerwert, z. B. `application/json`. |
[Tabelle : 1. Parameter]

{#GlideHTTPRequest-addHeader__table_ib1_31z_cfb} {#GlideHTTPRequest-addHeader__table_jb1_31z_cfb__entry__2}

| Typ | Beschreibung |
|-|-|
| void |   |
[Tabelle : 2. Ergebnisse]

{#GlideHTTPRequest-addHeader__table_jb1_31z_cfb}  
In diesem Beispiel wird der Anforderungsheader „Akzeptieren" hinzugefügt, und die Anzahl der Incidents wird aus einer ServiceNow-Instanz zurückgegeben, wobei die JSON- oder XML-Antworten analysiert werden.

    var instance = 'dev12345';
    var username = 'admin';
    var password = 'yourpassword';

    // Instantiate request with ServiceNow API incidents table endpoint
    var request = new GlideHTTPRequest('https://'+instance+'.service-now.com/api/now/table/incident');

    // Add authentication data
    request.setBasicAuth(username, password);

    // Add the Accept header to get JSON response
    request.addHeader('Accept', 'application/json');

    // Execute the GET request
    var response = request.get();

    // Print the results: status code and number of records returned
    gs.print(response.getStatusCode());
    gs.print('(JSON) Incidents returned: ' + JSON.parse(response.getBody()).result.length);

    // Replace the Accept header to get XML response
    request.addHeader('Accept', 'application/xml');

    // Execute the GET request
    var response = request.get();

    // Print the results: status code and number of records returned
    gs.print(response.getStatusCode());
    gs.print('(XML) Incidents returned: ' + gs.xmlToJSON(response.getBody()).response.result.length);

Ausgabe

    200
    (JSON) Incidents returned: 66
    200
    (XML) Incidents returned: 66

## GlideHTTPRequest -- addParameter(String name, String value) {#ariaid-title3}

Fügt Ihrer HTTP-Anforderung einen Parameter hinzu.
{#GlideHTTPRequest-addParameter__table_zk5_4dz_cfb__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Name | Zeichenfolge | Hinzuzufügender Parameter, z. B. sysparm_limit. |
| Wert | Zeichenfolge | Wert für den Parameter. |
[Tabelle : 3. Parameter]

{#GlideHTTPRequest-addParameter__table_zk5_4dz_cfb} {#GlideHTTPRequest-addParameter__entry__11}

| Typ | Beschreibung |
|-|-|
| void |   |
[Tabelle : 4. Ergebnisse]

In diesem Beispiel wird gezeigt, wie dem REST-Endpunktaufruf der Parameter sysparm_limit hinzugefügt wird, um die Anzahl der zurückgegebenen Antworten zu begrenzen.

    var instance = 'dev12345';
    var username = 'admin';
    var password = 'yourpassword';

    // Instantiate request with ServiceNow API incidents table endpoint
    var request = new GlideHTTPRequest('https://'+instance+'.service-now.com/api/now/table/incident');

    // Add authentication data
    request.setBasicAuth(username, password);

    // Add the 'sysparm_limit' parameter to limit the number of records returned
    request.addParameter('sysparm_limit', 1);

    // Execute the GET request
    var response = request.get();

    // Print the results: status code and number of records returned
    gs.print(response.getStatusCode());
    gs.print('Incidents returned: ' + JSON.parse(response.getBody()).result.length);

Ausgabe:

    200
    Incidents returned: 1

## GlideHTTPRequest -- setBasicAuth(String userName, String password) {#ariaid-title4}

Legt einen Anwendernamen und ein Passwort für die Standardauthentifizierung fest.
{#GlideHTTPRequest-setBasicAuth__table_xtx_5qy_cfb__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| userName | Zeichenfolge | Anwendername für die Authentifizierung. |
| Kennwort | Zeichenfolge | Für die Authentifizierung zu verwendendes Passwort des Anwenders. |
[Tabelle : 5. Parameter]

{#GlideHTTPRequest-setBasicAuth__table_xtx_5qy_cfb} {#GlideHTTPRequest-setBasicAuth__table_ytx_5qy_cfb__entry__2}

| Typ | Beschreibung |
|-|-|
| void |   |
[Tabelle : 6. Ergebnisse]

{#GlideHTTPRequest-setBasicAuth__table_ytx_5qy_cfb}  
In diesem Beispiel wird gezeigt, wie Sie mit der Methode setBasicAuth() den Anwendernamen und das Passwort für den zugehörigen REST-Endpunktaufruf festlegen.

    var instance = 'dev12345';
    var username = 'admin';
    var password = 'yourpassword';

    // Instantiate request with ServiceNow API incidents table endpoint
    var request = new GlideHTTPRequest('https://'+instance+'.service-now.com/api/now/table/incident');

    // Add authentication data
    request.setBasicAuth(username, password);

    // Add the Accept header to get JSON response
    request.addHeader('Accept', 'application/json');

    // Execute the GET request
    var response = request.get();

    // Print the results: status code and number of records returned
    gs.print(response.getStatusCode());
    gs.print('(JSON) Incidents returned: ' + JSON.parse(response.getBody()).result.length);

    // Replace the Accept header to get XML response
    request.addHeader('Accept', 'application/xml');

    // Execute the GET request
    var response = request.get();

    // Print the results: status code and number of records returned
    gs.print(response.getStatusCode());
    gs.print('(XML) Incidents returned: ' + gs.xmlToJSON(response.getBody()).response.result.length);

Ausgabe

    200
    (JSON) Incidents returned: 66
    200
    (XML) Incidents returned: 66

## GlideHTTPRequest -- setContentType(String type) {#ariaid-title5}

Legt den Inhaltstyp-Header für Ihre HTTP-Anforderung auf den angegebenen Wert fest.
{#GlideHTTPRequest-setContentType__table_lhw_vdz_cfb__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Typ | Zeichenfolge | Festzulegender Inhaltstyp, z. B. `application/json` oder `multipart/form-data`. Weitere Informationen zu Inhaltstyp finden Sie unter <https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Content-Type>. |
[Tabelle : 7. Parameter]

{#GlideHTTPRequest-setContentType__table_lhw_vdz_cfb} {#GlideHTTPRequest-setContentType__table_mhw_vdz_cfb__entry__2}

| Typ | Beschreibung |
|-|-|
| void |   |
[Tabelle : 8. Ergebnisse]

{#GlideHTTPRequest-setContentType__table_mhw_vdz_cfb}  
In diesem Beispiel wird gezeigt, wie der `Inhaltstyp-` Anforderungsheader für einen REST-Endpunktaufruf mithilfe der Methode „setContentType() " festgelegt wird.

    var instance = 'dev12345';
    var username = 'admin';
    var password = 'yourpassword';

    // Instantiate request with ServiceNow API incidents table endpoint
    var request = new GlideHTTPRequest('https://'+instance+'.service-now.com/api/now/table/incident');

    // Add authentication data
    request.setBasicAuth(username, password);

    // Set up incident record to post

    // Set the Content-Type of the POST
    request.setContentType('application/json');

    // Execute the POST request
    var response = request.post();

    // Print the results: status code and number of records returned
    gs.print(response.getStatusCode());

Ausgabe

    200

## GlideHTTPRequest -- setFollowRedirect(boolean followRedirect) {#ariaid-title6}

Aktiviert oder deaktiviert die Option „Weiterleitung verfolgen" für einen REST-Endpunktaufruf.
Weitere Informationen zu HTTP-Umleitungen finden Sie unter <https://developer.mozilla.org/en-US/docs/Web/HTTP/Redirections>.
{#GlideHTTPRequest-setFollowRedirect__table_kzt_pwy_cfb__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| FollowRedirect | Boolean | Kennzeichnung, die angibt, ob der Endpunkt einer vom Endpunkt zurückgegebenen URL-Umleitung folgen soll. Gültige Werte: * true: Nach jeder zurückgegebenen Umleitung. * „falsch": Alle zurückgegebenen Umleitungen ignorieren. Standardwert: true |
[Tabelle : 9. Parameter]

{#GlideHTTPRequest-setFollowRedirect__table_kzt_pwy_cfb} {#GlideHTTPRequest-setFollowRedirect__table_lzt_pwy_cfb__entry__2}

| Typ | Beschreibung |
|-|-|
| void |   |
[Tabelle : 10. Ergebnisse]

{#GlideHTTPRequest-setFollowRedirect__table_lzt_pwy_cfb}  
In diesem Beispiel wird gezeigt, wie Umleitungen für einen Endpunktaufruf mit der Methode „setFollowRedirect() " deaktiviert werden.

    var instance = 'dev12345';
    var username = 'admin';
    var password = 'yourpassword';

    // Instantiate request with ServiceNow API incidents table endpoint
    var request = new GlideHTTPRequest('https://'+instance+'.service-now.com/api/now/table/incident');

    // Add authentication data
    request.setBasicAuth(username, password);

    // Add the Accept header to get JSON response
    request.addHeader('Accept', 'application/json');

    // Turn off follow redirect - default is on (true)
    request.setFollowRedirect(false);

    // Execute the GET request
    var response = request.get();

    // Print the results: status code and number of records returned
    gs.print(response.getStatusCode());

Ausgabe

    200

## GlideHTTPRequest -- setHttpTimeout(int timeout) {#ariaid-title7}

Legt den HTTP-Zeitüberschreitungswert in Millisekunden fest.
{#GlideHTTPRequest-setHttpTimeout__table_rjp_1ly_cfb__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| timeout | Ganzzahl | Festzulegender Zeitüberschreitungswert. Einheit: Millisekunden |
[Tabelle : 11. Parameter]

{#GlideHTTPRequest-setHttpTimeout__table_rjp_1ly_cfb} {#GlideHTTPRequest-setHttpTimeout__table_sjp_1ly_cfb__entry__2}

| Typ | Beschreibung |
|-|-|
| void |   |
[Tabelle : 12. Ergebnisse]

{#GlideHTTPRequest-setHttpTimeout__table_sjp_1ly_cfb}  
In diesem Beispiel wird gezeigt, wie der Zeitüberschreitungswert für einen Endpunktaufruf mit der Methode setTimeout() festgelegt wird.

    var instance = 'dev12345';
    var username = 'admin';
    var password = 'yourpassword';

    // Instantiate request with ServiceNow API incidents table endpoint
    var request = new GlideHTTPRequest('https://'+instance+'.service-now.com/api/now/table/incident');

    // Add authentication data
    request.setBasicAuth(username, password);

    // Add the Accept header to get JSON response
    request.addHeader('Accept', 'application/json');

    // Set the time out value
    request.setHttpTimeOut(1000);

    // Execute the GET request
    var response = request.get();

    // Print the results: status code and number of records returned
    gs.print(response.getStatusCode());

Ausgabe

    200

## GlideHTTPRequest -- setLogLevel(String logLevel) {#ariaid-title8}

Legt die Protokollebene für eine HTTP-Anforderung fest.
{#GlideHTTPRequest-setLogLevel__table_ijx_myy_cfb__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| logLevel | Zeichenfolge | Die verfügbare Protokollierungsebene. Hinweis: Aus Leistungsgründen wird in der Produktion empfohlen, die HTTP-Anforderungsprotokollierung bei basiczu belassen. Gültige Werte: * Standard: Umfasst viele Attribute der HTTP-Transaktion, einschließlich Host, Pfad, Antwortstatus usw. * erhöht: Enthält alle basicsowie alle Anforderungsheader, die Abfragezeichenfolge und alle Antwortheader. * all: Enthält elevatedsowie den Anforderungstext und den Antworttext. Standard: einfach |
[Tabelle : 13. Parameter]

{#GlideHTTPRequest-setLogLevel__table_ijx_myy_cfb} {#GlideHTTPRequest-setLogLevel__table_jjx_myy_cfb__entry__2}

| Typ | Beschreibung |
|-|-|
| void |   |
[Tabelle : 14. Ergebnisse]

{#GlideHTTPRequest-setLogLevel__table_jjx_myy_cfb}  
In diesem Beispiel wird gezeigt, wie die Protokollebene für einen Endpunktaufruf mit der Methode setLogLevel() festgelegt wird.

    var instance = 'dev12345';
    var username = 'admin';
    var password = 'yourpassword';

    // Instantiate request with ServiceNow API incidents table endpoint
    var request = new GlideHTTPRequest('https://'+instance+'.service-now.com/api/now/table/incident');

    // Add authentication data
    request.setBasicAuth(username, password);

    // Add the Accept header to get JSON response
    request.addHeader('Accept', 'application/json');

    // Set the time out value
    request.setLogLevel(elevated);

    // Execute the GET request
    var response = request.get();

    // Print the results: status code and number of records returned
    gs.print(response.getStatusCode());

Ausgabe

    200

## GlideHTTPRequest -- setupProxy(String host, String port) {#ariaid-title9}

Legt den Proxy-Host und -Port für den zugehörigen REST-Aufruf fest.
{#GlideHTTPRequest-setupProxy__table_aww_sry_cfb__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| host | Zeichenfolge | Proxy-Host |
| port | Zeichenfolge | Proxy-Port |
[Tabelle : 15. Parameter]

{#GlideHTTPRequest-setupProxy__table_aww_sry_cfb} {#GlideHTTPRequest-setupProxy__table_bww_sry_cfb__entry__2}

| Typ | Beschreibung |
|-|-|
| void |   |
[Tabelle : 16. Ergebnisse]

{#GlideHTTPRequest-setupProxy__table_bww_sry_cfb}