Abrufen : Bereichsbezogen, global

  • Freigeben Version: Yokohama
  • Aktualisiert 30. Januar 2025
  • 2 Minuten Lesedauer

    • Die Abruf- API bietet Methoden zum Abrufen von Ressourcen mithilfe von Anforderungs- und Antwortobjekten.

    Sie können die Abruf- API in einem Hintergrundskript und überall verwenden, wo Sie HTTP-Aufrufe tätigen können (z. B. an einem REST-Endpunkt). Mit der Abruf- API können Sie durch Festlegen von Headern, Textkörperoptionen usw. einfache und komplexere Abrufanforderungen erstellen.

    Diese API ist Teil einer Reihe von Abruf -APIs, die verschiedene Aktionen zum Abrufen von Ressourcen von externen Websites bereitstellen. Die vollständige API-Sammlung zum Abrufen enthält:

    Zur Unterstützung von Abrufaktionen ermöglicht die Systemeigenschaft glide.hosts.allowlistdie Steuerung, auf welche Hosts eine Abrufmethode zugreifen kann. Sie gilt für HTTP-APIs wie RestMessageV2 und die oben genannten. Weitere Informationen zu glide.hosts.allowlistfinden Sie unter 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 wird, 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 Zeichenfolgenbezeichner, einschließlich eines URL-Objekts, das die URL der abzurufenden Ressource bereitstellt. Die URL kann relativ zur Basis-URL sein, die der baseURI des Dokuments ist.
    • Ein Anforderung abrufen – Request() -Objekt.
    Optionen Objekt Optional. Ein RequestInit abrufen : Bereichsbezogen, 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 in einem Antwortobjekt aufgelöst wird.
    Ein fetch() -Zusagen wird nur abgelehnt, wenn die Anforderung fehlschlägt, z. B. aufgrund einer falsch formatierten Anforderungs-URL oder eines Netzwerkfehlers.
    Hinweis:
    Eine fetch() -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 einen -Handler (then()), um die Eigenschaften „OK“ und „Status Antwort abrufen  – bereichsbezogen, global“ zu überprüfen.
    Im folgenden Beispiel wird veranschaulicht, wie mithilfe von Anforderung abrufen – Request() ein neues Anforderungsobjekt erstellt und anschließend die zugehörigen Daten mit fetch() abgerufen werden. Hier finden Sie eine einfache Erklärung, wie die einzelnen Teile des Codes verwendet werden:
    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" }
]