> ## Documentation Index
> Fetch the complete documentation index at: https://dokumentation.websale.de/llms.txt
> Use this file to discover all available pages before exploring further.

# REST-Schnittstellen Request

> Der einheitliche Aufbau jedes REST-Aufrufs an einen OSB-Dienst: URL aus SERVICEID und ACTION, Token im Header und die Bedeutung der Statuscodes.

Alle REST-Schnittstellen der OSB-Dienste sind gleich aufgebaut. Wer einen Dienst angebunden hat, kann den nächsten mit demselben Gerüst ansprechen und muss nur Dienstkennung, Aktion und Parameter austauschen.

## Aufbau der URL

```
https://www.websale.de/api/SERVICEID/ACTION
```

| Parameter | Bedeutung |
| - | - |
| `SERVICEID` | Kennung des OSB-Dienstes. Das ist nicht zwingend die AppID des Dienstes. Beispiele: `emm`, `hreflangCollector`, `images`, `pagespeedtool`, `websaleapp2`. |
| `ACTION` | Die Aktion, die der Dienst ausführen soll. Beispiele: `changeemail`, `start`, `cancel`, `publish`, `build`, `send`. |

Kennt ein Dienst die übergebene Aktion nicht, antwortet er mit dem HTTP-Code 400 für Bad Request.

## Token im Header

Jeder Aufruf braucht ein gültiges Token. Wie Sie es erzeugen, steht unter [REST-Authentifizierung](https://dokumentation.websale.de/v8s/schnittstellen/rest-osb-dienste/rest-authentifizierung.md). Übergeben wird es im Request-Header:

```
X-Authorization: Bearer TOKEN
```

Das Token ist ein JSON Web Token und besteht aus drei Teilen:

1. **Header** mit dem Algorithmus der Signatur und der Art des Tokens.
2. **Payload** mit den Informationen, die bei einem CGI-Aufruf im Kontext stehen, dazu ein Timestamp für die Gültigkeit.
3. **Signatur**, ein verschlüsselter Hash aus Header und Payload.

Ein Token ist 30 Minuten gültig. Danach beantwortet die API jede Anfrage mit dem Statuscode 401 und Sie fordern ein neues an. Bauen Sie das in Ihre Anbindung ein, bevor Sie einen länger laufenden Ablauf automatisieren.

## Fehlerbehandlung

Jeder Dienst gibt einen zum Vorfall passenden HTTP-Code zurück. Der wichtigste Fall ist immer gleich: Wer ohne gültiges Token auf eine Ressource zugreift, erhält 401.

## Verwandte Themen

* Wegweiser: [REST-Schnittstelle für OSB-Dienste](https://dokumentation.websale.de/v8s/schnittstellen/rest-osb-dienste.md)
* Wegweiser: [REST-Authentifizierung](https://dokumentation.websale.de/v8s/schnittstellen/rest-osb-dienste/rest-authentifizierung.md)


## Related topics

- [REST-Authentifizierung](https://dokumentation.websale.de/v8s/schnittstellen/rest-osb-dienste/rest-authentifizierung.md)
- [REST-Schnittstelle für OSB-Dienste](https://dokumentation.websale.de/v8s/schnittstellen/rest-osb-dienste.md)
- [REST Textpflege](https://dokumentation.websale.de/v8s/schnittstellen/rest-osb-dienste/rest-textpflege.md)
- [REST Kategorien](https://dokumentation.websale.de/v8s/schnittstellen/rest-osb-dienste/rest-kategorien.md)
- [REST WEBSALE-App](https://dokumentation.websale.de/v8s/schnittstellen/rest-osb-dienste/rest-websale-app.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.