Authentifizierung

Sie müssen sich authentifizieren, um auf die REST-API zugreifen zu können. Dazu müssen Sie einen Bearer Token generieren, den Sie in den Request-Header einfügen.

Bearer Token

Den Bearer Token können Sie im Modul ZEP-Schnittstellen in Ihrem ZEP generieren. Hier sehen Sie ein Beispiel, wie Sie den generierten Token mit cURL in den Request-Header einfügen:

Beispiel der Authentifizierung mit Bearer Token

curl --request GET \
     --url 'https://www.zep-online.de/zepinstanz/next/api/v1/customers' \
     --header 'Accept: application/json' \
     --header 'Authorization: Bearer {token}'

⚠️

Bewahren Sie Ihren persönlichen Token immer sicher auf und setzen Sie ihn zurück, wenn Sie vermuten, dass er missbraucht wurde. Bitte übermitteln Sie Ihr ZEP Passwort und Ihren Token nicht an GitHub o.ä.

Rate Limiting

Die API hat ein Rate Limit von 1000 Anfragen pro 5 Minuten. Wird dieses Limit überschritten, sind weitere Anfragen für 60 Sekunden gesperrt. Sie erhalten dann eine Fehlermeldung mit dem HTTP-Statuscode 429.

Bitte kontaktieren Sie Ihren Kundenberater, wenn das vorgegebene Limit nicht ausreicht und Sie eine höhere Anzahl an Anfragen benötigen.

Schnellstart Paginierung