Das Manifest schreiben

Das Manifest beschreibt, was die App ist und was sie darf. Es ist ein GESCHLOSSENER Vertrag: ein Feld, das hier nicht vorgesehen ist, führt zur Ablehnung — nicht zum stillen Ignorieren. Das ist Absicht, weil ein stillschweigend verworfenes Feld sonst als Zusage gelesen würde, die nie gegolten hat.

`schemaVersion` ist 1, `apiVersion` ist „v1". `appUrl` ist die HTTPS-Adresse der extern gehosteten App, die im Dashboard eingebettet wird. `redirectUris` braucht mindestens einen Eintrag und höchstens zehn; die Adressen werden beim OAuth-Ablauf EXAKT verglichen, nicht per Präfix. `surface` darf derzeit nur „app.home" sein — andere Oberflächen gibt es noch nicht, und eine zu behaupten wäre eine Zusage ohne Einlösung.

`requiredScopes` sind die Rechte, ohne die die App nicht läuft — der Wirt kann sie nicht abwählen. `optionalScopes` darf er einzeln abwählen, die App muss dann ohne sie funktionieren. Zusammen sind höchstens 32 Rechte erlaubt. Verlangt werden darf nur, was eine tatsächlich vorhandene REST-Operation abdeckt.

`dataPurpose`, `retentionDays`, `hostingCountry` und `protectedData` sind die Datenschutzangaben, die der Wirt beim Zustimmen liest. Der Zweck darf bis 2000 Zeichen lang sein und soll im Klartext stehen, nicht in Juristensprache. `retentionDays: 0` heißt: nichts wird dauerhaft gespeichert — eine Zusage, die man einhalten muss. `hostingCountry` ist ein Länderkürzel aus zwei Großbuchstaben. Diese Angaben sind Ihre Zusage, nicht unsere Prüfung; sie stehen dem Wirt dauerhaft vor Augen.

`webhookUrl` ist optional. Ohne sie erfährt die App nichts von Ereignissen wie einer Deinstallation oder einer Löschaufforderung — dann muss sie selbst nachfragen. Zugangsdaten gehören NIEMALS ins Manifest: es wird gespeichert, geprüft und dem Wirt angezeigt.