Eine API-App erstellen

Eine App gibt Ihrer eigenen Software Zugriff auf die Softalon API unter https://api.softalon.com/v1. Jede App hat eine Client-ID und ein Client-Secret, mit denen sie über OAuth 2.0 Zugriffstokens abruft.

Es gibt zwei Arten von Apps:

Eine Salon-App erstellen

1. 1

   Schritt 1 von 5

   Apps öffnen

   Gehen Sie zu Einstellungen › Entwickler › Apps und klicken Sie auf App erstellen.

2. 2

   Schritt 2 von 5

   Die App benennen

   Geben Sie einen App-Name ein. Diesen Namen sehen Personen, wenn sie gebeten werden, Ihre App zu autorisieren.

3. 3

   Schritt 3 von 5

   Scopes hinzufügen

   Fügen Sie unter Scopes jede Berechtigung, die Ihre App braucht, einzeln hinzu. Ihre App kann nur Scopes anfordern, die Sie hier hinzufügen. Siehe die Liste der Scopes unten.

4. 4

   Schritt 4 von 5

   Redirect-URIs hinzufügen

   Fügen Sie unter Redirect-URIs jede vollständige URL hinzu, über die Ihre App OAuth-Antworten empfängt, zum Beispiel https://app.example.com/oauth/callback. Ihre App kann nur URIs verwenden, die Sie hier hinzufügen. Wenn Ihre App nur von einem Server aus mit der API kommuniziert, können Sie diesen Schritt überspringen.

5. 5

   Schritt 5 von 5

   Die App erstellen und das Secret speichern

   Klicken Sie auf App erstellen.

   Das sehen Sie:

   Ein Dialog mit den Zugangsdaten, Ihrer Client-ID und Ihrem Client-Secret.

   Kopieren Sie beide und bewahren Sie sie sofort an einem sicheren Ort auf.

Eine Konto-App erstellen

Gehen Sie zu Konto › Apps und klicken Sie auf App registrieren. Die Felder und das einmalig angezeigte Secret funktionieren genauso wie bei einer Salon-App.

Scopes

Scopes haben die Form area:action.

Fügen Sie nur die Scopes hinzu, die Ihre App braucht.

Tokens abrufen

Apps unterstützen diese OAuth-2.0-Grant-Typen:

• Client credentials für den Zugriff von Server zu Server ohne Benutzer.
• Authorization code, wenn sich eine Person anmeldet und Ihre App genehmigt. Siehe Einer App Zugriff auf Ihr Konto erlauben.
• Refresh token, um neue Zugriffstokens zu erhalten, ohne erneut zu fragen.

Wenn Ihre App ein Token anfordert, sendet sie ihre Client-ID und ihr Secret per HTTP-Basic-Authentifizierung.

Eine App bearbeiten oder löschen

Öffnen Sie das Menü der App in der Tabelle:

• Aktualisieren ändert den Namen, die Scopes oder die Redirect-URIs. Client-ID und Secret bleiben gleich.
• Löschen entfernt die App und ihre Zugangsdaten. Systeme, die sie verwenden, können danach keine Tokens mehr abrufen.