Durch die Mark.One API ist es möglich das Mark.One Konto sicher mit anderen Software-Programmen, die in Verwendung sind, zu verbinden. Es wird dadurch ein automatischer Austausch von Daten zwischen den Programmen ermöglicht. Beispielsweise werden Manuelles Exportieren, Kopieren oder erneutes Eintippen nicht mehr erforderlich. Auch moderne Agentenbasierte KI Systeme können so zu Daten berechtigt werden.
Dieser Artikel gibt einen nicht-technischen Überblick über die Möglichkeiten der Verwendung der API. Werden die vollständigen technischen Details benötigt, kann dies hier abgerufen werden: **[Entwicklerdokumentation](https://markone-docs.codemagic.app/)**
Übersicht
Was ist eine API?
Was kann die API?
Häufige Anwendungsbeispiele
Einrichtung - vereinfacht
Wer führt die Einrichtung durch?
Bereit loszulegen?
1 Was ist eine API (Application Programming Interface)?
Die API kann man sich als sichere Türe zu den eigenen Mark.One Daten vorstellen.
Es meldet sich jedoch keine Person an und klickt sich durch die Oberfläche, sondern eine andere Software kann Mark.One nach Informationen fragen oder senden. Dies geschieht dann automatisch und in Echtzeit.
Beispiele:
"Gib mir eine Übersicht über die Verkäufe von gestern"
"Erstelle diese Bestellung"
Dadurch werden Integrationen ermöglicht, wie:
individuelle Dashboards
Online Shops
Treue Apps
etc.
2 Was kann die API?
Die API bietet programmatischen Zugriff auf die wichtigsten Geschäftsdaten.
Aktuell sind folgende Bearbeitungen möglich:
Belege
Verkaufsbelege für einen beliebigen Zeitraum abrufen.
z.B. für die Dashboards oder Analysen
Bestellungen
Automatisches Erstellen, Abrufen und Aktualisieren von Kundenbestellungen.
Filialen
Information zu den Filialen und Standorten abrufen.
Artikel
Zugriff auf den eigenen Produkt-/Artikelkatalog inklusive Verfügbarkeit pro Filiale und Datum.
Rezepte
Abruf von Rezeptinformationen.
Zutaten
Abruf von Zutateninformationen.
Weitere Datentypen werden im Zuge der Weiterentwicklung der Plattform hinzugefügt.
3 Häufige Anwendungsbeispiele
Folgend sind Beispiele aufgelistet, wie die API in Unternehmen umgesetzt werden kann.
Individuelle Dashboards & Reporting
Aktuelle Verkaufszahlen können in eigene Analyse-Tools oder BI-Dashboards eingespeist werden.
Online-Bestellungen & Webshop
Externe Webseiten oder Apps können Bestellungen direkt in der Mark.One App anlegen.
Katalog Synchronistation
Produkt-, Rezept- und Zutateninformationen werden über mehrere Systeme hinweg synchron gehalten.
Drittanbieter-Integrationen
Treueprogramme, Lieferplattformen oder andere spezialisierte Tools können mit Mark.One verbunden werden.
4 Einrichtung - vereinfacht
Ein Systemadministrator erstellt im "Marketplace" des Kontos einen sicheren API Schlüssel.
Dieser Schlüssel wird der Software oder dem Entwickler übergeben, welche/welcher die Verbindung herstellen soll.
Die verbundene Software kann anschließend sicher auf die Mark.One-Daten zugreifen, diese lesen oder schreiben.
Durch Löschen des API-Schlüssel im Marketplace kann der Zugriff verbundener Softwaren jederzeit widerrufen werden.
Sicherheitstipp: API-Schlüssel gewähren vollen Zugriff auf Ihre Daten. Geben Sie diese nur an vertrauenswürdige Partner weiter und geben sie diese niemals öffentlich bekannt.
5 Wer führt die Einrichtung durch?
Die API richtet sich an Entwickler, die entweder Teil des internen technischen Teams sind oder aus externen Partnerschaften herangezogen werden. Die Integration von Mark.One mit einem anderen System wird durch diese durchgeführt.
Dieses Dokument sollte somit an die Person weitergeleitet werden, welche die Integration durchführt.
6 Bereit loszulegen?
Alle technischen Details – Authentifizierung, Endpunkte, Anfrageformate und Beispiele – finden Sie in unserer Entwicklerdokumentation:
[MarkOne Entwicklerdokumentation](https://markone-docs.codemagic.app/)
Bei Fragen oder wenn Sie Unterstützung benötigen, wenden Sie sich jederzeit an unser Support Team - Wir helfen Ihnen gerne weiter.