GlideHTTPRequest – Global

  • Freigeben Version: Zurich
  • Aktualisiert 31. Juli 2025
  • 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 mithilfe des Konstruktors. Der Konstruktor benötigt eine Endpunkt-URL als Eingabeparameter.

    GlideHTTPRequest – addHeader(String name, String value)

    Fügt Ihrer HTTP-Anforderung einen Header hinzu.

    Tabelle : 1. Parameter
    Name Typ Beschreibung
    Name Zeichenfolge Headername, z. B. Akzeptieren Oder Inhaltstyp .
    Wert Zeichenfolge Headerwert, z. B. Anwendung/JSON .
    Tabelle : 2. Rückgaben
    Typ Beschreibung
    void

    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(String name, String value)

    Fügt Ihrer HTTP-Anforderung einen Parameter hinzu.

    Tabelle : 3. Parameter
    Name Typ Beschreibung
    Name Zeichenfolge Hinzuzufügender Parameter, z. B. sysparm_limit.
    Wert Zeichenfolge Wert für den Parameter.
    Tabelle : 4. Rückgaben
    Typ Beschreibung
    void

    Dieses Beispiel zeigt, wie Sie hinzufügen sysparm_limitParameter für den REST-Endpunktaufruf, 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)

    Legt einen Anwendernamen und ein Passwort für die Standardauthentifizierung fest.

    Tabelle : 5. Parameter
    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 : 6. Rückgaben
    Typ Beschreibung
    void

    Dieses Beispiel zeigt die Verwendung von 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(String type)

    Legt den Content-Type-Header für Ihre HTTP-Anforderung auf den angegebenen Wert fest.

    Tabelle : 7. Parameter
    Name Typ Beschreibung
    Typ Zeichenfolge Festzulegender Inhaltstyp, z. B. Anwendung/JSON Oder Multipart/Formulardaten . Weitere Informationen zum Inhaltstyp finden Sie unter https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Content-Type.
    Tabelle : 8. Rückgaben
    Typ Beschreibung
    void

    Dieses Beispiel zeigt, wie festgelegt wird Inhaltstyp Anforderungsheader für einen REST-Endpunktaufruf 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(boolean followRedirect)

    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.

    Tabelle : 9. Parameter
    Name Typ Beschreibung
    Folgeumleitung 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: Ignorieren Sie jede zurückgegebene Umleitung.
    Standardwert: wahr
    Tabelle : 10. Rückgaben
    Typ Beschreibung
    void

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

    Legt den HTTP-Zeitüberschreitungswert in Millisekunden fest.

    Tabelle : 11. Parameter
    Name Typ Beschreibung
    timeout Ganzzahl Festzulegender Zeitüberschreitungswert.

    Einheit: Millisekunden
    Tabelle : 12. Rückgaben
    Typ Beschreibung
    void

    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(String logLevel)

    Legt die Protokollebene für eine HTTP-Anforderung fest.

    Tabelle : 13. Parameter
    Name Typ Beschreibung
    logLevel Zeichenfolge Die verfügbare Protokollierungsebene.
    Hinweis:
    Aus Leistungsgründen ist es in der Produktion ratsam, die HTTP-Anforderungsprotokollierung bei zu verlassen basic.

    Gültige Werte:

    • Standard: Deckt viele Attribute der HTTP-Transaktion ab, einschließlich Host, Pfad, Antwortstatus usw.
    • Erhöht: Enthält alle basic, Sowie alle Anforderungsheader, die Abfragezeichenfolge und alle Antwortheader.
    • Alle: Enthält alle elevated, Sowie den Anforderungstext und den Antworttext.

    Standard: Standard
    Tabelle : 14. Rückgaben
    Typ Beschreibung
    void

    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(String host, String port)

    Legt den Proxy-Host und -Port für den zugehörigen REST-Aufruf fest.

    Tabelle : 15. Parameter
    Name Typ Beschreibung
    host Zeichenfolge Proxy-Host
    port Zeichenfolge Proxy-Port
    Tabelle : 16. Rückgaben
    Typ Beschreibung
    void