Freigabe und Verzeichnis

Die Stände einer App#

Einreichen#

1. 1

   Die Checkliste abarbeiten

   Einreichen lässt sich erst, wenn alles erledigt ist: Name (2 bis 60 Zeichen), Logo, Beschreibung, Website, Adresse der Datenschutzerklärung, Support-E-Mail, mindestens eine gültige Redirect-URI (bei einer vertraulichen App eine https-Adresse), eine Verbindung zu deinem Test-Betrieb, mindestens eine Anfrage mit Status 2xx in den letzten 14 Tagen und, wenn deine App einen Webhook hat, mindestens eine erfolgreiche Zustellung in den letzten 30 Tagen.

   Konsole › App › Freigabe

2. 2

   Zur Freigabe einreichen

   Der Stand wechselt auf „In Prüfung“. In dieser Zeit lässt sich die App nicht bearbeiten. Solange Flavoso nicht entschieden hat, holst du sie mit „Einreichung zurückziehen“ zurück in die Entwicklung.

   Konsole › App › Freigabe

3. 3

   Entscheidung abwarten

   In der Regel wenige Werktage. Die Entscheidung kommt per E-Mail; eine Ablehnung mit Begründung. Dann bearbeitest du die App und reichst neu ein.

Was geprüft wird#

• Die Angaben sind vollständig und die Adressen erreichbar.
• Name und Logo täuschen nicht: keine fremde Marke, kein Anschein, die App sei von Flavoso.
• Die App fragt nur die Rechte an, die sie für ihren Zweck braucht.

Checkliste vor dem Einreichen#

• Der ganze Ablauf ist mit dem Test-Betrieb durchgespielt: verbinden, Bestellungen, Speisekarte, Fehlerfälle, trennen.
• Tokens liegen verschlüsselt auf deinem Server, das Client-Secret nie in einer App oder im Browser.
• Das Refresh-Token wird je Verbindung an genau einer Stelle erneuert, und gespeichert wird immer das neue.
• Webhook-Signaturen werden geprüft, Doppelte an der id erkannt.
• Jeder POST trägt einen Idempotency-Key; 429 und 5xx werden mit Abstand wiederholt.
• livemode: false landet nie in echten Daten.
• app.disconnected und invalid_grant beim Erneuern führen zu einer klaren Anzeige mit „Neu verbinden“; unauthorized_client zeigt „vorübergehend gesperrt“ und behält die Tokens.
• Deine Software zeigt, mit welchem Betrieb sie verbunden ist, und kann trennen (DELETE /connection).
• Die Support-Adresse wird gelesen.

Nach der Freigabe#

Ab der Freigabe kann jeder Inhaber deine App verbinden, und der Zustimmungsbildschirm zeigt „Von Flavoso geprüft“.

• Sofort gelten: Änderungen an Beschreibung und Support-E-Mail, und eine gestrichene Redirect-URI.
• Auf eine neue Prüfung warten: Name, Logo, Website, Adresse der Datenschutzerklärung, neue Redirect-URIs, zusätzliche Rechte und neue Angaben im App-Verzeichnis (Rubrik, Kurzbeschreibung, Installationsadresse). Bis dahin gilt die geprüfte Fassung.

Das App-Verzeichnis#

Jede freigegebene App steht im App-Verzeichnis, wo Betriebe sie finden: im Dashboard unter Einstellungen, Integrationen, und öffentlich unter flavoso.com/<sprache>/integrations. So sieht ein Betrieb, womit er sich verbinden kann. Den Eintrag pflegst du in den Einstellungen deiner App, und er gehört zur Checkliste vor dem Einreichen:

Im Verzeichnis stehen nur freigegebene Apps, und dort steht jede. Austragen lässt sich eine freigegebene App nicht; wer sie nicht mehr anbieten will, löscht sie. Wird eine App gesperrt, verschwindet ihr Eintrag.

Die Marke Flavoso#

• Schreib Flavoso so: ein Wort, großes F. Nicht als Teil des Namens deiner App, der nach Flavoso selbst klingt („Flavoso Kasse“); „Kasse X für Flavoso“ ist in Ordnung.
• Das Logo von Flavoso ist nicht das Symbol deiner App.
• „Von Flavoso geprüft“ zeigt nur Flavoso, auf dem Zustimmungsbildschirm und im Verzeichnis. Behaupte keine Partnerschaft, Zertifizierung oder Empfehlung, die es nicht gibt.
• Der Knopf heißt „Mit Flavoso verbinden“ (in anderen Sprachen siehe Authentifizierung).

Sperre#

Bei Verstoß gegen die Entwicklerbedingungen oder bei Missbrauch kann Flavoso eine App sperren. Ihre Tokens werden ab dann mit 401 abgewiesen, Zustellungen übersprungen, und niemand kann sie neu verbinden. Die Verbindungen bleiben bestehen: hebt Flavoso die Sperre auf, läuft alles weiter.

Beim Erneuern antwortet der Token-Endpunkt in dieser Zeit mit 400 unauthorized_client, nicht mit invalid_grant. Behalte die Tokens, zeig „vorübergehend gesperrt“ an und versuch es später wieder. Ereignisse aus der Zeit der Sperre können fehlen, auch in GET /events, ohne dass gap es anzeigt. Gleiche nach dem Ende der Sperre deshalb über die Listen ab, etwa mit GET /orders?updated_since=….

Eine App löschen#

In den Einstellungen deiner App löschst du sie. Damit enden alle ihre Verbindungen, und kein Token der App gilt mehr. Das lässt sich nicht rückgängig machen; für einen Neuanfang legst du eine neue App an.