Apps
Apps erweitern deinen Shop um zusätzliche Funktionen und Integrationen, die über den Standard hinausgehen. Du kannst damit externe Services anbinden, eigene Workflows automatisieren oder individuelle Features direkt in dein Backend integrieren.
Die Anbindung erfolgt über das OAuth-Verfahren. Das bedeutet: Du gibst der App nicht deinen Smarda-Login, sondern erteilst ihr separate, eingeschränkte Zugriffsberechtigung, die du jederzeit widerrufen kannst.
Marketplace-Apps installieren
Im ersten Bereich findest du alle Apps, die dir im Marketplace zur Verfügung stehen. Diese werden von Smarda oder Smarda-Partnern bereitgestellt und können direkt in deinem Shop genutzt werden. Jede App zeigt dir eine kurze Beschreibung sowie die benötigten Berechtigungen.
Mit einem Klick auf „Installieren“ startest du den OAuth-Prozess im Hintergrund. Die App wird eingerichtet und erhält Zugriff auf die freigegebenen Bereiche.
Installierte Apps verwalten
Hier siehst du alle Apps, die aktuell in deinem Shop aktiv sind. Du kannst jede Installation im Detail einsehen, inklusive Status, Berechtigungen und Erstellungsdatum. Falls die App eine eigene Benutzeroberfläche mitbringt, kannst diese direkt im Backend eingebettet anzeigen lassen.
Über die Verwaltung kannst du Apps jederzeit widerrufen. Dadurch werden alle zugehörigen Zugriffe und Tokens sofort ungültig gemacht.
Eigene Apps anlegen
In diesem Bereich kannst du eigene Apps erstellen, um individuelle Integrationen umzusetzen. Das ist besonders hilfreich, wenn du externe Tools anbinden oder eigene Prozesse automatisieren möchtest.
Beim Erstellen definierst du Name, Beschreibung deiner App und die gewünschten Berechtigungen. Wenn du eine externe Benutzeroberfläche einbetten möchtest, kannst du diese über die optionale iFrame-URL hinzufügen.
Nach dem Anlegen erhälst du eine Client-ID und ein Client-Secret. Diese werden nur einmal angezeigt. Speichere sie deshalb umgehend sicher ab!
- Du legst unter "Meine Apps" eine App an und gibst die entsprechenden Berechtigungen an.
- Smarda gibt Client-ID und Client-Secret aus. Du speicherst diese Zugangsdaten an einen sicheren Ort auf.
- Die beiden Werte trägst du in das Programm ein, mit welchem du dich in Smarda verbinden möchtest.
- Dein Programm meldet sich damit bei unserer API an.
- Smarda prüft die Zugangsdaten und lässt das Programm nur an die freigegebenen Daten (Scopes), für die du die App berechtigt hast.
Client-ID und Client-Secret
Client-ID = der "Benutzername" der App. Sie ist nicht geheim und nur zur Idenfitikation da.
Client-Secret = das "Passwort" der App. Sie ist geheim und wird bei Erstellung nur einmal angezeigt und muss vom Nutzer sicher gespeichert werden. Secrets können erneuert werden, aber dadurch wird das alte Secret ungültig.
Smarda erzeugt und prüft diese Zugangsdaten.