Erste Schritte mit der Zonos API

Hinweis: Zonos verwendet GraphQL als primäre API mit vollem Funktionsumfang. REST-Endpunkte werden mit eingeschränktem Support nur für Legacy-Integrationen gepflegt. Für neue Integrationen nutzen Sie bitte unsere GraphQL API.

Die Zonos REST API bietet ressourcenorientierte URLs, liefert JSON-codierte Antworten, akzeptiert form-codierte Anfragekörper und verwendet standardmäßige HTTP-Antwortcodes und Authentifizierung.

Für den Zugriff auf die Zonos API benötigen Sie einen API-Schlüssel. Derselbe API-Schlüssel wird sowohl zu Testzwecken als auch im Live-Betrieb verwendet. Der API-Schlüssel dient zur Authentifizierung der Anfragen.

Wir fügen unserer API regelmäßig Felder hinzu. Um Fehler nach der Integration zu vermeiden, empfehlen wir, unbekannte Felder zu ignorieren.

Authentifizierung 

Zonos verwendet API-Schlüssel, um den Zugriff auf die API zu ermöglichen. Sie können sich hier für ein neues Zonos-Konto und einen API-Schlüssel registrieren.

Der API-Schlüssel wird bei allen API-Anfragen an den Server in einem Header übermittelt, der wie folgt aussieht:

serviceToken: meowmeowmeow

Hinweis: Ersetzen Sie meowmeowmeow durch Ihren API-Schlüssel.

Version 

Um auf die REST-API-Version zuzugreifen, senden Sie den Header zonos-version. Prüfen Sie die entsprechende API-Dokumentation auf die passenden Header-Informationen, sofern zutreffend und erforderlich.

Wenn keine Version angegeben wird, wird standardmäßig die zuletzt unterstützte Version verwendet.

Der aktuelle Versions-Header lautet zonos-version: 2021-01-01.