Der Hauptvorteil der APIs in MasterBase® besteht darin, dass sie die Automatisierung von Aktionen ermöglichen, die manuell auf der Webplattform durchgeführt werden.
Sie machen es unter anderem möglich:
Aktualisieren Sie Ihre Datenbanken in Ihrer Arbeitsumgebung und auf unserer Plattform gleichzeitig.
Erstellen und versenden Sie Nachrichten von Ihren Systemen aus, ohne sich bei unserer Plattform anmelden zu müssen.
Erhalten Sie von MasterBase® Ihre Sendungskennzahlen
MasterBase® API
Lernen Sie von unseren APIs
API-Anmeldeinformationen: Warum sie erstellen und wie man sie erstellt
Um die URL des Dienstes, den Sie nutzen möchten, zu erstellen, müssen Sie die folgende Struktur verwenden:
Basis-URL zur Gruppierung der Webdienste:
https://api2023.masterbase.com
zu dem Sie zunächst das Segment hinzufügen müssen, das den Dienst angibt, auf den es verweist, und dann die optionalen Parameter, die Ihre betreffende Abfrage definieren. Vor dem ersten dieser Parameter steht ein Fragezeichen (?), gefolgt von einem Gleichheitszeichen (=) und dem Wert des Parameters. Ab dem zweiten Parameter, den Sie hinzufügen möchten, müssen Sie das kaufmännische Und-Zeichen (&) anstelle des Fragezeichens verwenden.
Beispiel:
https://api2023.masterbase.com/Kontakte/v2/Kundenname/?Von=123&Oben=100&Bestellung=1
Struktur
Der Umschlag
Jede Antwort ist in einer Struktur enthalten, die als Briefumschlag (Umschlag, Wrapper). Dies bedeutet, dass jede Antwort eine vordefinierte Struktur hat, mit der sie interagieren kann.
{
"Dienst": "Name des Dienstes",
"Version": "Version des Dienstes",
"TransactionId": "Alphanumerische Transaktionskennung",
"Status": {
Code": "Antwortcode", "Code": "Antwortcode", "Wert": "Wert der Antwort",
"Wert": "Wert der Antwort", "Wert": "Wert der Antwort", "Wert": "Wert der Antwort
},
"Daten": {}
}
Status
Der Schlüssel Status wird verwendet, um Informationen über die Antwort des Dienstes zu erhalten. Wenn alles korrekt abgelaufen ist, enthält die Antwort im Code-Attribut den Wert 200 oder 201. Es kann jedoch vorkommen, dass etwas schief läuft, dann erhalten Sie eine Antwort dieser Art:
"Status": {
"Code": "401",
"Value": "Unauthorized"
}
Authentifizierung
Für die Inanspruchnahme der auf dieser Website verfügbaren Webdienste ist eine grundlegende Zugangsauthentifizierung erforderlich. Zu diesem Zweck werden API-Zugangsdaten - Benutzer und Passwort - verwendet, die Sie über Ihr MasterBase®-Konto erhalten. Die Verwendung dieser Daten hängt von der für die Nutzung der Dienste gewählten Sprache ab und liegt in der Verantwortung des Nutzers.