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


---

# GlideHTTPRequest -- Global

# GlideHTTPRequest -- Global {#ariaid-title1}

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

Die GlideHTTPRequest Die API stellt Dienstprogrammmethoden zur Ausführung allgemeiner Funktionen mit Glide-HTTP-Anforderungen bereit.

Sie können diese API in globalen serverseitigen Skripts verwenden. Um diese Klasse zu verwenden, instanziieren Sie ein GlideHTTPRequest-Objekt mit dem Konstruktor. Der Konstruktor erfordert eine Endpunkt-URL als Eingabeparameter.

## GlideHTTPRequest -- addHeader(Zeichenfolgenname, Zeichenfolgenwert) {#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. `Anwendung/JSON `. |
[Tabelle : 1. Parameter]

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

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

{#GlideHTTPRequest-addHeader__table_jb1_31z_cfb}  
In diesem Beispiel wird der Anforderungsheader „Akzeptieren" hinzugefügt und die Anzahl der Incidents 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(Zeichenfolgenname, Zeichenfolgenwert) {#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 |
|-|-|
| Ungültig |   |
[Tabelle : 4. Rückgaben]

Dieses Beispiel zeigt, wie hinzugefügt wird sysparm_limitParameter für den REST-Endpunkt-Aufruf, 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(Anwendername für Zeichenfolge, Passwort für Zeichenfolge) {#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, der für die Authentifizierung verwendet werden soll. |
| Passwort | Zeichenfolge | Passwort des Anwenders, das für die Authentifizierung verwendet werden soll. |
[Tabelle : 5. Parameter]

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

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

{#GlideHTTPRequest-setBasicAuth__table_ytx_5qy_cfb}  
Dieses Beispiel zeigt, wie verwendet wird SetBasicAuth() Methode zum Festlegen des Anwendernamens und Passworts für den zugehörigen REST-Endpunktaufruf.

    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(Zeichenfolgentyp) {#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. `Anwendung/JSON `Oder `Mehrteilig/Formulardaten `. Weitere Informationen zum 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 |
|-|-|
| Ungültig |   |
[Tabelle : 8. Rückgaben]

{#GlideHTTPRequest-setContentType__table_mhw_vdz_cfb}  
Dieses Beispiel zeigt, wie festgelegt wird `Inhaltstyp `Anforderungsheader für einen REST-Endpunkt-Aufruf mit SetContentType() Methode.

    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(boolescher Folgeredirect) {#ariaid-title6}

Aktiviert oder deaktiviert die Option „Umleitung folgen" 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 |
|-|-|-|
| Follow-Weiterleitung | Boolean | Kennzeichnung, die angibt, ob der Endpunkt einer vom Endpunkt zurückgegebenen URL-Umleitung folgen soll. Gültige Werte: * Wahr: Folgt einer zurückgegebenen Umleitung. * Falsch: Alle zurückgegebenen Umleitungen ignorieren. Standard: Wahr |
[Tabelle : 9. Parameter]

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

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

{#GlideHTTPRequest-setFollowRedirect__table_lzt_pwy_cfb}  
Dieses Beispiel zeigt, wie Umleitungen für einen Endpunktaufruf mit deaktiviert werden SetFollowRedirect() Methode.

    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-Zeitüberschreitung) {#ariaid-title7}

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

| Name | Typ | Beschreibung |
|-|-|-|
| Zeitüberschreitung | 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 |
|-|-|
| Ungültig |   |
[Tabelle : 12. Rückgaben]

{#GlideHTTPRequest-setHttpTimeout__table_sjp_1ly_cfb}  
Dieses Beispiel zeigt, wie der Zeitüberschreitungswert für einen Endpunktaufruf mit festgelegt wird SetTimeout() Methode.

    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 (Zeichenfolge 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 Ebene der verfügbaren Protokollierung. Hinweis: Aus Leistungsgründen ist es in der Produktion ratsam, die HTTP-Anforderungsprotokollierung unter zu verlassen basic. Gültige Werte: * Standard: Deckt viele Attribute der HTTP-Transaktion ab, einschließlich Host, Pfad, Antwortstatus usw. * Erhöht: Schließt alle ein basic, Sowie alle Anforderungsheader, die Abfragezeichenfolge und alle Antwortheader. * Alle: Schließt alle ein elevated, Sowie den Anforderungstext und den Antworttext. Standard: Standard |
[Tabelle : 13. Parameter]

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

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

{#GlideHTTPRequest-setLogLevel__table_jjx_myy_cfb}  
Dieses Beispiel zeigt, wie die Protokollebene für einen Endpunktaufruf mit festgelegt wird SetLogLevel() Methode.

    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 (Zeichenfolgenhost, Zeichenfolgenport) {#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 |
|-|-|
| Ungültig |   |
[Tabelle : 16. Rückgaben]

{#GlideHTTPRequest-setupProxy__table_bww_sry_cfb}

