Abrufen – Umfang, Global

Die Abrufen Die API stellt Methoden zum Abrufen von Ressourcen mithilfe von Anforderungs- und Antwortobjekten bereit.

Sie können verwenden Abrufen API in einem Hintergrundskript und überall, wo Sie HTTP-Aufrufe tätigen können (z. B. ein REST-Endpunkt). Die Abrufen Mit der API können Sie sowohl einfache als auch kompliziertere Abrufanforderungen erstellen, indem Sie Header, Textoptionen usw. festlegen.

Diese API ist Teil eines Satzes von Abrufen APIs, die verschiedene Aktionen zum Abrufen von Ressourcen von externen Websites bereitstellen. Die vollständige API-Sammlung „Abrufen“ umfasst:

• Abrufen – Abrufen (Zeichenfolgenressource, Objektoptionen): Startet den Prozess des Abrufs einer Ressource aus dem Netzwerk.
• Header Abrufen – Umfang, Global: Anforderungs- und Antwortheader abrufen und ändern.
• Anforderung Abrufen – Umfang, Global: Erstellen Sie ein neues Anforderungsobjekt.
• Rufen Sie „RequestInit“ ab – Umfang, Global: Legen Sie Optionen zum Konfigurieren einer Abrufanforderung fest.
• Antwort Abrufen – Umfang, Global: Erstellen Sie ein neues Antwortobjekt.

Zur Unterstützung von Abrufaktionen die Systemeigenschaft Glide.Hosts.Zulässigkeitsliste , Ermöglicht Steuerungen darüber, auf welche Hosts eine Abrufmethode zugreifen kann. Gilt für HTTP-APIs wie RestMessageV2 Und die oben genannten. Weitere Informationen zu finden Glide.Hosts.Zulässigkeitsliste , Siehe Available system properties.

Abrufen – Abrufen (Zeichenfolgenressource, Objektoptionen)

Startet den Prozess zum Abrufen einer Ressource aus dem Netzwerk und gibt eine Zusage zurück, die erfüllt ist, sobald die Antwort verfügbar ist.

Tabelle : 1. Parameter

Name	Typ	Beschreibung
Ressource	Zeichenfolge oder Objekt	Erforderlich. Die abzurufende Ressource. Akzeptierte Werte: Eine Zeichenfolge oder ein Objekt mit einem Stringifier, einschließlich eines URL-Objekts, das die URL der Ressource bereitstellt, die Sie abrufen möchten. Die URL kann relativ zur Basis-URL sein, die der baseURI des Dokuments ist. A Anforderung Abrufen – Request() Objekt.
Optionen	Objekt	Optional. A Rufen Sie „RequestInit“ ab – Umfang, Global Objekt mit anwenderdefinierten Einstellungen, die auf die Anforderung angewendet werden sollen. Standard: Die Anforderung wird ohne Anpassungseinstellungen übergeben.

Tabelle : 2. Rückgaben

Typ

Beschreibung

Objekt

Eine Zusage, die zu einem Antwortobjekt aufgelöst wird. A Abrufen () Die Zusage wird nur abgelehnt, wenn die Anforderung fehlschlägt, z. B. aufgrund einer schlecht formatierten Anforderungs-URL oder eines Netzwerkfehlers. Hinweis: A Abrufen () Die Zusage gilt nicht als abgelehnt, wenn der Server mit HTTP-Statuscodes antwortet, die auf Fehler wie 404 oder 504 hinweisen. Verwenden Sie in dieser Instanz eine Then() Handler zum Überprüfen des OK- und -Status Antwort Abrufen – Umfang, Global Eigenschaften.

Das folgende Beispiel zeigt, wie mit ein neues Anforderungsobjekt erstellt wird Anforderung Abrufen – Request() Und dann Abrufen () Um die zugehörigen Daten abzurufen. Hier ist eine einfache Erklärung, wie jeder Teil des Codes verwendet wird:

• Anforderung () : Konfiguriert die API-Anforderung mit URL, Methode und Header.
• Abrufen () : Stellt die Abrufanforderung.
• Antwort.JSON() : Analysiert den JSON-Antworttext in ein JavaScript-Objekt. (Siehe Antwort abrufen – JSON() Für weitere Informationen.)
• Console.log() : Gibt die Incidents (Data.result) mit aus Konsole API (siehe Konsole – log(Object val1...val2, Zeichenfolgennachricht, Zeichenfolgensubst1...subst2)).

async function fetchIncidents() {
    const url = 'https://your-instance.service-now.com/api/now/table/incident';
    const username = 'your_username';
    const password = 'your_password';

    // Create a Request object
    const request = new Request(url, {
        method: 'GET',
        headers: {
            'Content-Type': 'application/json',
            Authorization: 'Basic ' + btoa(`${username}:${password}`)
        }
    });

    // Fetch data and use response.json() to process it
    const response = await fetch(request);
    const data = await response.json(); // Parse the response to JSON
    console.log(data.result); // Log the incidents data to system logs
}

fetchIncidents();

Ausgabe:

[
    { "number": "INC0001", "short_description": "System outage" },
    { "number": "INC0002", "short_description": "Password reset request" }
]