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


---

# WSD-Schicht-API

# WSD-Schicht-API {#ariaid-title1}

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

Die Workplace Service Delivery(WSD) Schicht Die API stellt einen Endpunkt bereit, der Schichtzeitspannen für ein bestimmtes Datum und eine bestimmte Uhrzeit zurückgibt.
Um auf diese API zuzugreifen, muss der Anrufer über die Rolle „sn_wsd_core.workplace_user" verfügen, und die Plugins „Arbeitsplatzsicherheitsmanagement" (sn_wsd_Core) und „Arbeitsplatzreservierungsmanagement" (sn_wsd_rsv) müssen aktiviert sein.

Diese API wird in ausgeführt `sn_wsd_rsv `Namespace.

Für zusätzliche Informationen zu Management von Arbeitsplatz-Reservierungen, Siehe [Verwaltung Von Arbeitsplatzreservierungen](https://www.servicenow.com/docs/access?context=workplace-rsv-mgmt-feat&version=yokohama&pubname=yokohama-employee-service-management&ft:locale=en-US).

## WSD-Schicht: /api/sn_wsd_rsv/wsd_Shift/{SHIFT_ID}/timespan ABRUFEN {#ariaid-title2}

Gibt die Schichtzeitspanne für ein angegebenes Datum/eine angegebene Uhrzeit und eine angegebene Schicht zurück.
<br />

### URL-Format

Versionierte URL: /api/sn_wsd_rsv/{api_Version}/wsd_SHIFT/{SHIFT_ID}/Timespan

Standard-URL: /api/sn_wsd_rsv/wsd_SHIFT/{SHIFT_ID}/timespan  
Hinweis:  
Verfügbare Versionen werden in angegeben [REST-API-Explorer](https://servicenow-prod.fluidtopics.net/QZyr9s_~V0xB9fqGOlvJ4A "In diesem Tutorial verwenden Sie den REST API Explorer, um zu testen ServiceNowREST-APIs."). Für geskriptete REST-APIs gibt es zusätzliche Versionsinformationen auf [Geskriptetes REST-Service-Formular](https://servicenow-prod.fluidtopics.net/0V9QfkPsOI5r~YAD7CJWCA "Mit der geskripteten REST-API-Funktion können Anwendungsentwickler anwenderdefinierte Webservice-APIs erstellen.").

### Unterstützte Anforderungsparameter

{#wsd_shift-GET-timespan__entry__2}{#wsd_shift-GET-timespan__version-not_optional-RESTAPI}

| Name | Beschreibung |
|-|-|
| api_version | Optional. Version des Endpunkts, auf den zugegriffen werden soll. Beispiel: <kbd class="ph userinput">v1 </kbd>Oder <kbd class="ph userinput">v2 </kbd>. Geben Sie diesen Wert nur an, um eine andere Endpunktversion als die neueste zu verwenden. Datentyp: Zeichenfolge |
| Shift_ID | SYS_ID der Schicht, für die die Zeitspanne abgerufen werden soll. Weitere Informationen zu schichtbasierten Reservierungen finden Sie unter [Schichtbasierte Reservierung aktivieren](https://www.servicenow.com/docs/access?context=wsd-reservation-setup&version=yokohama&pubname=yokohama-employee-service-management&ft:locale=en-US). Datentyp: Zeichenfolge Tabelle: Schicht \[sn_wsd_core_shift\] |
[Tabelle : 1. Pfad-Parameter]

{#wsd_shift-GET-timespan__entry__8}

| Name | Beschreibung |
|-|-|
| Versuch_früher_Start | Kennzeichnung, die angibt, ob eine frühe Startzeit festgelegt werden soll, wenn der angegebene Startwert innerhalb der Zeitspanne der Schicht liegt. Gültige Werte: * Wahr: Wenn die angegebene Schicht das Datum/die Uhrzeit enthält, die in angegeben sind startParameter, gibt das angegebene Startdatum/-Uhrzeit als Beginn der Zeitspanne zurück. * Falsch: Gibt die Schichtzeitspanne zurück, wie im zugehörigen Datensatz definiert. Datentyp: Boolescher Wert Standard: Falsch |
| start | Erforderlich. Datum und Uhrzeit des Starts der zurückzugebenden Schichtzeitspannen. Format: UTC -- jjjj-mm-ddThh:mm:ssZ, z. B. 2022-05-23T08:00:00Z |
| Feld | Zeitzone, die bei der Qualifizierung der Schichtzeitspannen verwendet werden soll, z. B. ECT oder PST. Gibt auch die Schichtzeitspannen in dieser Zeitzone zurück. Format: UTC Datentyp: Zeichenfolge Standard: Zeitzone des Anwenders |
[Tabelle : 2. Abfrageparameter]

{#wsd_shift-GET-timespan__entry__16}

| Name | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 3. Anforderungstext-Parameter]

### Header

Die folgenden Anforderungs- und Antwort-Header gelten nur für diese HTTP-Aktion oder werden auf diese Aktion in einer bestimmten Weise angewendet. Eine Liste der allgemeinen Header, die in der REST-API verwendet werden, finden Sie unter [Unterstützte REST-API-Header](https://servicenow-prod.fluidtopics.net/ai2El07oZMsuDDSV75uftQ "REST (repräsentative Statusübertragung) ist eine einfache statuslose Architektur, die Standards zwischen Computersystemen im Web bereitstellt, wodurch sie leichter miteinander kommunizieren können.").
{#wsd_shift-GET-timespan__entry__20}{#wsd_shift-GET-timespan__accept-reserv-entry}

| Header | Beschreibung |
|-|-|
| Akzeptieren | Datenformat des Anforderungstexts. Unterstützte Typen: application/json, application/xmlOder, text/xml. Standard: application/json |
[Tabelle : 4. Anforderungskopfzeilen.]

{#wsd_shift-GET-timespan__entry__24}

| Header | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 5. Antwort-Header]

### Statuscodes

Die folgenden Statuscodes gelten für diese HTTP-Aktion. Eine Liste der möglichen Statuscodes, die in der REST-API verwendet werden, finden Sie unter [REST-API-HTTP-Antwortcodes](https://servicenow-prod.fluidtopics.net/ai2El07oZMsuDDSV75uftQ "REST (repräsentative Statusübertragung) ist eine einfache statuslose Architektur, die Standards zwischen Computersystemen im Web bereitstellt, wodurch sie leichter miteinander kommunizieren können.").
{#wsd_shift-GET-timespan__entry__28}{#wsd_shift-GET-timespan__entry-200-status-code}{#wsd_shift-GET-timespan__entry-401-status-code}{#wsd_shift-GET-timespan__entry-404-status-code}{#wsd_shift-GET-timespan__entry-500-status-code}

| Statuscode | Beschreibung |
|-|-|
| 200 | Erfolgreich. Die Anforderung wurde erfolgreich verarbeitet. |
| 401 | Nicht autorisiert Die Anwenderanmeldeinformationen sind falsch oder wurden nicht übergeben. |
| 404 | Nicht gefunden. Das angeforderte Element wurde nicht gefunden. |
| 500 | Interner Serverfehler. Beim Verarbeiten der Anforderung ist ein unerwarteter Fehler aufgetreten. Die Antwort enthält zusätzliche Informationen zum Fehler. |
[Tabelle : 6. Statuscodes]

### Antworttext-Parameter

{#wsd_shift-GET-timespan__entry__38}

| Name | Beschreibung |
|-|-|
| Ergebnis | Details zur Schichtzeitspanne, die den Suchkriterien entsprach. Datentyp: Objekt "result":{ "end": "String", "start": "String" } |
| Ergebnis.Ende | Enddatum und -Uhrzeit der Schichtzeitspanne in der angegebenen Zeitzone. Format: UTC: jjjj-mm-ddThh:mm:ssZ, z. B. 2022-05-23T08:00:00Z Datentyp: Zeichenfolge |
| Ergebnis.Start | Startdatum und -Uhrzeit der Schichtzeitspanne in der angegebenen Zeitzone. Format: UTC: jjjj-mm-ddThh:mm:ssZ, z. B. 2022-05-23T08:00:00Z Datentyp: Zeichenfolge |
[ ]

### Curl-Anforderung

Das folgende Codebeispiel zeigt, wie die Zeitspanne einer Schicht abgerufen wird.

    curl "https://instance.servicenow.com/api/sn_wsd_rsv/wsd_shift/e5d23acfdb42a01097acc9003996193a/timespan?attempt_earlier_start=true&start=2022-05-23T08:00:00Z&timezone=ECT" \
    --request GET \
    --header "Accept:application/json" \
    --user "username":"password"

Ergebnisse zurückgeben:

    {
      "result": {
        "start": "2022-05-23T08:00:00Z",
        "end": "2022-05-23T15:00:00Z"
      }
    }


