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


---

# Abrufen -- Umfang, Global

# Abrufen -- Umfang, Global {#ariaid-title1}

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

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 dort, wo Sie HTTP-Aufrufe tätigen können (wie ein REST-Endpunkt). Die Abrufen Mit der API können Sie einfache und 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 zum Abrufen umfasst:

* [Abrufen -- Abrufen (Zeichenfolgenressource, Objektoptionen)](https://servicenow-prod.fluidtopics.net/AwrAhKNGXaLxw1ZC79Ebww#fetch.fetch_S_O "Startet den Prozess des Abrufs einer Ressource aus dem Netzwerk und gibt eine Zusage zurück, die erfüllt wird, sobald die Antwort verfügbar ist."): Startet den Prozess zum Abrufen einer Ressource aus dem Netzwerk.
* [Header Abrufen -- Umfang, Global](https://servicenow-prod.fluidtopics.net/8xlkjooH2aJiEhCejNeIPA#Fetch.HeadersAPI "Die Header Abrufen Mit der API können Sie Header aus einer Liste von Anforderungs- oder Antwortheadern abrufen, festlegen, hinzufügen und entfernen."): Ruft Anforderungs- und Antwortheader ab und ändert sie.
* [Anforderung Abrufen -- Umfang, Global](https://servicenow-prod.fluidtopics.net/_IVSKGlRao8N9tpSmy34gw#Fetch.RequestAPI "Die Anforderung Abrufen API enthält Methoden zum Erstellen oder Abrufen eines Anforderungsobjekts, damit Anwendungen Ressourcen wie JSON, Text oder Binärdaten asynchron von einem Server anfordern können. und bearbeiten Sie die Antwort. Diese API unterstützt verschiedene HTTP-Methoden wie GET, POST, PUT, DELETE usw."): Erstellen Sie ein neues Anforderungsobjekt.
* [Rufen Sie „Anforderungsinitiit" ab -- Umfang, Global](https://servicenow-prod.fluidtopics.net/WVLdzExaUW_rqWMI7EaOzA#Fetch.RequestInitAPI "Die Anforderung initiieren Die API bietet Optionen zum Konfigurieren einer Abrufanforderung."): Legen Sie Optionen zum Konfigurieren einer Abrufanforderung fest.
* [Antwort Abrufen -- Umfang, Global](https://servicenow-prod.fluidtopics.net/25mxwH4S7LdH6buFK7jGEg#Fetch.ResponseAPI "Die Antwort Abrufen Die API bietet Methoden zum Erstellen eines neuen Antwortobjekts und zur Verarbeitung des von einem erstellten Antworttexts Anforderung Abrufen API-Methode."): Erstellen Sie ein neues Antwortobjekt.
{#FetchAPI__ul_akb_fsf_pdc}

Zur Unterstützung von Abrufaktionen die Systemeigenschaft `Glide.Hosts.Zulässigkeitsliste `, Ermöglicht Steuerungen darüber, auf welche Hosts eine Abrufmethode zugreifen kann. Dies gilt für HTTP-APIs wie RestMessageV2 Und die oben genannten. Für weitere Informationen zu `Glide.Hosts.Zulässigkeitsliste `, Siehe [Available system properties](https://www.servicenow.com/docs/access?context=r_AvailableSystemProperties&version=yokohama&pubname=yokohama-platform-administration&ft:locale=en-US).

## Abrufen -- Abrufen (Zeichenfolgenressource, Objektoptionen) {#ariaid-title2}

Startet den Prozess des Abrufs einer Ressource aus dem Netzwerk und gibt eine Zusage zurück, die erfüllt wird, sobald die Antwort verfügbar ist.
{#fetch.fetch_S_O__table_arq_npb_jdc__entry__3}

| 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()](https://servicenow-prod.fluidtopics.net/_IVSKGlRao8N9tpSmy34gw#fetch.request-constructor "Erstellt ein neues Anforderungsobjekt. Erstellen Sie optional das Anforderungsobjekt aus einer URL oder Objektressource.")Objekt. {#fetch.fetch_S_O__ul_lbz_kqb_jdc} |
| Optionen | Objekt | Optional. A [Rufen Sie „Anforderungsinitiit" ab -- Umfang, Global](https://servicenow-prod.fluidtopics.net/WVLdzExaUW_rqWMI7EaOzA#Fetch.RequestInitAPI "Die Anforderung initiieren Die API bietet Optionen zum Konfigurieren einer Abrufanforderung.")Objekt mit anwenderdefinierten Einstellungen, die auf die Anforderung angewendet werden sollen. Standard: Die Anforderung wird ohne Anpassungseinstellungen übergeben. |
[Tabelle : 1. Parameter]

{#fetch.fetch_S_O__table_arq_npb_jdc} {#fetch.fetch_S_O__table_brq_npb_jdc__entry__2}

| Typ | Beschreibung |
|-|-|
| Objekt | Eine Zusage, die zu einem Antwortobjekt aufgelöst wird. A Abrufen() 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 Dann() Handler zum Überprüfen von OK und Status [Antwort Abrufen -- Umfang, Global](https://servicenow-prod.fluidtopics.net/25mxwH4S7LdH6buFK7jGEg#Fetch.ResponseAPI "Die Antwort Abrufen Die API bietet Methoden zum Erstellen eines neuen Antwortobjekts und zur Verarbeitung des von einem erstellten Antworttexts Anforderung Abrufen API-Methode.")Eigenschaften. |
[Tabelle : 2. Rückgaben]

{#fetch.fetch_S_O__table_brq_npb_jdc}  
Das folgende Beispiel demonstriert, wie mit ein neues Anforderungsobjekt erstellt wird [Anforderung Abrufen -- Request()](https://servicenow-prod.fluidtopics.net/_IVSKGlRao8N9tpSmy34gw#fetch.request-constructor "Erstellt ein neues Anforderungsobjekt. Erstellen Sie optional das Anforderungsobjekt aus einer URL oder Objektressource.")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 Headern.
* Abrufen() : Stellt die Abrufanforderung.
* Antwort.JSON() : Analysiert den JSON-Antworttext in ein JavaScript-Objekt. (Siehe [Antwort abrufen -- JSON()](https://servicenow-prod.fluidtopics.net/25mxwH4S7LdH6buFK7jGEg#fetch.response-json "Gibt eine Zusage zurück, die als Ergebnis der Analyse des Textkörpers als JSON aufgelöst wird.")Für weitere Informationen.)
* Console.log() : Gibt die Incidents (Data.result) mit aus Konsole API (siehe [Konsole -- Protokoll(Object val1...val2, Zeichenfolgennachricht, Zeichenfolgensubst1...subst2)](https://servicenow-prod.fluidtopics.net/CTvI1Gr4kIwjKTVntWZDYg#console-log_O_S_S "Protokolliert eine Nachricht in Systemprotokollen.")).
{#fetch.fetch_S_O__ul_d4f_5br_c2c}

    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" }
    ]


