RestAPI Overview
Grundlegende Anforderungen
- Die REST-API ist so konzipiert, dass sie den HTTP- und RESTful-Spezifikationen entspricht. Verwenden Sie beispielsweise die GET-Methode für Abfrageanfragen und die POST-Methode für Übermittlungsanfragen. Wenn eine Anfrage nicht mit der entsprechenden HTTP-Methode gestellt wird, wird ein Fehler zurückgegeben.
- Sofern nicht anders angegeben, müssen die Parameter in UTF-8 kodiert und URL-codiert übermittelt werden.
Rechenzentren und Basis-URLs
| Rechenzentrum | Basis-URL |
|---|---|
| Singapur | https://ma-api.engagelab.com |
| Virginia, USA | https://ma-api-usva.engagelab.com |
Bei der Nutzung der REST-API müssen Sie die ausgewählte Basis-URL mit dem jeweiligen API-Pfad kombinieren, um die vollständige Aufrufadresse zu erhalten.
{Basis-URL}/{API-Pfad}
{Basis-URL}/{API-Pfad}
Diesen Codeblock im schwebenden Fenster anzeigen
Authentifizierungsmethode
Die EngageLab REST-API verwendet die Authentifizierungsmethode der HTTP-Basis-Authentifizierung: Fügen Sie dem HTTP-Header die Autorisierung hinzu:
Authorization: Basic ${base64_auth_string}
Authorization: Basic ${base64_auth_string}
Diesen Codeblock im schwebenden Fenster anzeigen
Der base64_auth_string wird nach folgendem Schema erzeugt: base64(api_key:api_secret).
- Der Header-Name ist „Authorization“, und der Wert ist das base64-kodierte „Benutzername:Passwort“-Paar (durch Doppelpunkt getrennt).
- Für die MA API entspricht der Benutzername dem APIKey und das Passwort dem APISecret. Bitte richten Sie eine API-Datenquelle des Typs „API“ ein, um den APIKey und das APISecret zu erhalten.
