--- title: "Vorbereitung von Datenquellen: ServiceNow API" url: "https://docs.noreja.com/de/article/vorbereitung-von-datenquellen-servicenow-api" language: "de" last_updated: "2026-02-28T11:35:05.073Z" --- # Vorbereitung von Datenquellen: ServiceNow API Die Vorbereitung einer ServiceNow-Datenquelle stellt sicher, dass IT- und Geschäftsprozesse sicher, strukturiert und performant angebunden werden können. Durch die Nutzung der integrierten REST-Schnittstellen – darunter Table API, Aggregate API, Attachment API, Import Set API und Scripted REST APIs – wird eine zuverlässige Datenkommunikation unter Einhaltung von Sicherheits- und Governance-Standards ermöglicht. Eine sauber konfigurierte ServiceNow-API-Anbindung bildet die Grundlage für eine nahtlose Integration mit Noreja und unterstützt skalierbare, sichere Prozessanalysen. ## Überblick Im Folgenden findest du eine konsolidierte Referenz der am häufigsten verwendeten REST API-Endpunkte von ServiceNow. Diese integrierten APIs ermöglichen CRUD-Operationen auf Tabellen, statistische Auswertungen, das Verwalten von Anhängen, die Verarbeitung externer Daten über Import Sets sowie benutzerdefinierte Schnittstellen via Scripted REST APIs. Nutze den REST API Explorer in deiner Instanz (System Web Services ▶ Inbound ▶ REST API Explorer), um Anfragen zu testen und verfügbare Parameter zu prüfen. ### **Kernschnittstellen von ServiceNow** | API-Typ | Endpunkt-Format | Beschreibung | | --- | --- | --- | | **Table API** | `/api/now/table/{tableName}` | Standard-CRUD für jede Tabelle | | **Aggregate API** | `/api/now/stats/{tableName}` | Zählungen und statistische Auswertungen | | **Attachment API** | `/api/now/attachment/*` | Anhänge hoch-/runterladen und auflisten | | **Import Set API** | `/api/now/import/{stagingTableName}` | Massenimport externer Daten mit Transformation | | **Scripted REST API** | `/api/{namespace}/{api_id}/…` | Benutzerdefinierte Endpunkte mit serverseitiger Logik | ## Table API Ermöglicht Create, Read, Update und Delete auf jeder ServiceNow-Tabelle. **Basis-URI:** ````plaintext https://.service-now.com/api/now/table/{tableName} ``` :contentReference[oaicite:5]{index=5} ```` **Unterstützte Methoden:** - `GET` – Datensätze abrufen - `POST` – Neuen Datensatz erstellen - `PUT` / `PATCH` – Datensatz aktualisieren - `DELETE` – Datensatz löschen **Typische Parameter:** - `sysparm_query` – Query-String (z. B. `active=true^priority=1`) - `sysparm_limit` / `sysparm_offset` – Paginierung - `sysparm_fields` – Nur bestimmte Felder abrufen - `sysparm_display_value` – Anzeige- statt Rohwert (`true`/`false`) **Beispiel: Top 10 Incidents mit Priorität 1 abrufen:** ````plaintext GET https://.service-now.com/api/now/table/incident ?sysparm_limit=10 &sysparm_query=priority=1 &sysparm_fields=number,short_description,priority ``` :contentReference[oaicite:6]{index=6} ```` ## Aggregate API Gibt zusammengefasste Statistiken (z. B. Zählungen, Summen) zurück, ohne vollständige Datensätze zu laden. **Basis-URI:** ````plaintext https://.service-now.com/api/now/stats/{tableName} ``` :contentReference[oaicite:7]{index=7} ```` **Unterstützte Methode:** - Nur `GET` **Typische Parameter:** - `sysparm_count=true` – Gibt die Gesamtanzahl zurück - `sysparm_sum_fields` – Felder zur Summenbildung - `sysparm_group_by` – Gruppierung nach Feldern - `sysparm_query` – Gefilterte Teilmenge **Beispiel: Zähle Incidents mit Priorität 1:** ````plaintext GET https://.service-now.com/api/now/stats/incident ?sysparm_count=true &sysparm_query=priority=1 ``` :contentReference[oaicite:8]{index=8} ```` ### **Attachment API** Ermöglicht das Hochladen, Abrufen, Auflisten und Löschen von Dateianhängen für beliebige Tabellen. **Datei hochladen:** ```plaintext POST https://.service-now.com/api/now/attachment/file ?table_name={tableName} &table_sys_id={recordSysId} &file_name={filename} ``` Content-Type: `multipart/form-data` oder binär [servicenow.com](https://www.servicenow.com/docs/bundle/yokohama-api-reference/page/integrate/inbound-rest/concept/c_AttachmentAPI.html?utm_source=chatgpt.com) **Datei herunterladen:** ```plaintext GET https://.service-now.com/api/now/attachment/{attachmentSysId}/file ``` **Anhänge zu einem Datensatz auflisten:** ```plaintext GET https://.service-now.com/api/now/attachment ?sysparm_query=table_name={tableName}^table_sys_id={recordSysId} ``` **Anhang löschen:** ```plaintext DELETE https://.service-now.com/api/now/attachment/{attachmentSysId} ``` ## Import Set API Dient zur Zwischenspeicherung und Verarbeitung externer Daten vor dem Laden in Zieltabellen. **Einzeldatensatz einfügen:** ```plaintext POST https://.service-now.com/api/now/import/{stagingTableName} ``` Body: JSON-Objekt, das einen einzelnen Datensatz repräsentiert [servicenow.com](https://www.servicenow.com/community/developer-articles/import-set-api-goodbye-srapis/ta-p/2318624?utm_source=chatgpt.com) **Mehrere Datensätze einfügen:** ```plaintext POST https://.service-now.com/api/now/import/{stagingTableName}/insertMultiple ``` Body: `{  "records": [    { ... },    { ... }  ] }`  [ahmeddrar.me](https://ahmeddrar.me/2021/05/15/quebec-tour-part-3import-set-rest-api-insert-multiple/?utm_source=chatgpt.com) **Wichtige Query-Parameter** Keine – das Mapping und die Transformation erfolgen vollständig **nach dem Staging** innerhalb von ServiceNow. ## Scripted REST API Erlaubt die Erstellung vollständig benutzerdefinierter REST-Endpunkte mit serverseitigem Script-Handling. **Ort der Definition:** Navigiere in der Instanz unter **System Web Services ▶ Scripted REST APIs.** [servicenow.com](https://www.servicenow.com/community/developer-forum/what-is-difference-between-table-api-import-set-api-and-scripted/m-p/3265574?utm_source=chatgpt.com) **URI-Muster:** ```plaintext https://.service-now.com/api/{namespace}/{api_id}/{resourcePath} ``` **Typische Methoden:** - `GET`, `POST`, `PUT`, `DELETE` – gemäß deiner Skriptdefinition - Benutzerdefiniertes Request-/Response-Scripting in der Scripted REST-Ressource **Typische Anwendungsfälle:** - Komplexe Geschäftslogik - Datenformate oder Workflows außerhalb der Standard-APIs - Versionierte und abgesicherte benutzerdefinierte Schnittstellen ## Endpunkte entdecken und testen #### **REST API Explorer** - In deiner ServiceNow-Instanz findest du den **REST API Explorer** unter: **System Web Services ▶ REST API Explorer** - Dort kannst du: integrierte APIs durchsuchen, Beispielanfragen dynamisch zusammenstellen und verfügbare Parameter und Antwortstrukturen einsehen ### **Versionierung** - Viele REST-Endpunkte unterstützen Versionierung, z. B.: `/api/now/v1/...` oder`/api/now/v2/...` - Wenn keine Version angegeben wird, verwendet ServiceNow automatisch die aktuell empfohlene und stabile API-Version. ## Authentifizierung & Sicherheit **Unterstützte Authentifizierungsverfahren:** - **Basic Authentication** (Benutzername/Passwort) - **OAuth 2.0** *(empfohlen für produktive Integrationen)* - **Mutual TLS** (Zertifikatsbasierte Authentifizierung auf Instanzebene) **Rate Limits & Best Practices** - Nutze `**sysparm_limit**` und `**sysparm_offset**`, um große oder blockierende Anfragen zu vermeiden. [blog.josephvelliah.com](https://blog.josephvelliah.com/pull-table-data-from-servicenow-instance-using-rest-api?utm_source=chatgpt.com) - Verwende **indexfreundliche Filter** in `sysparm_query`, um die Performance zu optimieren. Durch den Einsatz der integrierten REST-Schnittstellen von ServiceNow kannst du die Anbindung und Kommunikation mit einem Tool wie Noreja nahtlos und sicher gestalten. Die APIs bieten standardisierte, leistungsfähige Zugänge zum Datenmodell – flexibel erweiterbar durch benutzerdefinierte Endpunkte, starke Authentifizierungsmechanismen und moderne Abfrageoptionen.