Das Ökosystem

Software, auf der Gastronomie wirklich läuft

SIDES ist die Plattform hinter der Theke: Bestellungen, Filialen, Küchen, Webshops, Lieferung, Zahlung. Das Partnerökosystem ist alles, was Unternehmen darum herum bauen, die nicht wir sind — und SIDES LABS ist der Ort, an dem diese Arbeit stattfindet.

Partner werden Wie es funktioniert

Was es ist

Ein Marktplatz mit einem Vertrag dahinter

Ein Geschäftspartner ist ein bei SIDES LABS registriertes Softwareunternehmen. Es baut einen Dienst gegen die SIDES API, reicht ihn zur Prüfung ein und listet ihn — nach der Freigabe — im SIDES-Marktplatz, wo Gastronomiebetriebe ihn aus dem Produkt heraus finden, das sie ohnehin benutzen.

Das ist der ganze Kreis, und jeder Teil davon ist eine vollwertige Funktion der Plattform und keine je Partner ausgehandelte Vereinbarung: die Tarife, die Entwicklerressourcen, das API-Changelog, der Einreichungs- und Freigabeablauf, die Bewertungen und die Nutzungsstatistiken, die Ihnen sagen, wie die Anbindung tatsächlich läuft.

Die Wortmarke SIDES LABS im Zentrum eines Netzes verbundener Knoten.

Der Weg

Wie ein Partner auf der API baut

Fünf Schritte. Die Reihenfolge zählt, denn nichts wird für einen SIDES-Kunden sichtbar ohne einen ausdrücklichen, festgehaltenen Zustandswechsel.

  1. Den Geschäftspartner registrieren

    Unternehmen, erster Administrator, Tarif und die dazugehörigen Einwilligungen. Der Partner beginnt unbestätigt und ist bis zur Bestätigung nicht öffentlich sichtbar.

  2. Anmelden

    Server-zu-Server-Anbindungen melden sich als OAuth 2.0-Clients an und erhalten ein kurzlebiges Zugriffstoken. Das ist die Ebene, die es heute gibt. Partnernutzer werden sich für dieselbe Art Token anmelden, geprüft von derselben Middleware.

  3. Mit den gewährten Berechtigungen bauen

    Berechtigungen sind hierarchisch, nach Domäne verschachtelt und nur lesend, sofern sie nicht enden auf :write. Was Ihnen gewährt wurde, steht in der Token-Antwort — lesen Sie sie, statt Ihre Anfrage zu unterstellen.

  4. Eine App-Version einreichen

    Eintragstext, Bildschirmfotos, Kategorien und die Version selbst gehen gemeinsam ein. SIDES prüft die Einreichung; Freigabe und Ablehnung werden beide festgehalten.

  5. Veröffentlichen, dann messen

    Der freigegebene Eintrag erscheint im Marktplatz. Nutzungsstatistiken, Bewertungen und Rezensionen kommen im Partnerbereich des Portals zu Ihnen zurück.

Die andere Seite

Wer die Kunden sind

Keine Entwickler. Betreiber — die Menschen, die den Betrieb führen, während Ihre Software darunter läuft.

Restaurants und Filialen

Einzelstandorte und Ketten, die Bestellungen über Theke, Telefon, Webshop und Lieferplattformen annehmen, die alle in einem System landen.

Küchen und Produktion

Zubereitung, Weiterleitung und Disposition, wo zwei Minuten Verzug echte Kosten sind und eine gescheiterte Anbindung sichtbare.

Zentralen

Franchise- und Mehrstandortverwaltung: Auswertung, Preise, Speisekarten und Ausrollen über alle Standorte auf einmal.

Worauf Sie sich verlassen können

Die API ist ein Vertrag, und er wird gehalten

Keine brechenden Änderungen
Felder, Endpunkte und Aufzählungswerte werden frei ergänzt. Entfernen, Umbenennen oder Typänderung brauchen eine neue Hauptversion mit mindestens sechs Monaten Vorlauf.
Eine Fehlerform
RFC 7807 Problem Details bei jedem Fehlschlag, mit einem stabilen code , auf den Ihr Client verzweigt, und einer Anfragekennung, die Sie zitieren können.
Abschottung durch Bauweise
Ein Partner sieht nie die Apps, Statistiken, Umsätze oder das Team eines anderen Partners. Das wird serverseitig durchgesetzt, bei jeder Abfrage, und nicht durch einen Filter in einer Maske.
Nichts von anderswo geladen
Kein CDN, kein Schriftenhoster, kein Analysepixel irgendwo auf dieser Website. Eine IP-Adresse ist ein personenbezogenes Datum, und eine Anfrage an einen Dritten legt sie offen.
Markenschleife von SIDES LABS — zehn Sekunden, ohne Ton. Die Wortmarke steht ruhig, während ein Netz verbundener Knoten darüberzieht und wieder verblasst. Sie trägt nichts, was nicht auch auf dieser Seite steht.

Ehrlicher Stand

Was es heute gibt

Die Plattform wird offen gebaut

Heute authentifiziert die API OAuth-Maschinenclients und beantwortet GET /v1/system/me mit Identität, Berechtigungen und Ratenbegrenzung des aufrufenden Prinzipals. Partnerregistrierung und Anmeldung, der Marktplatzkatalog, das Changelog und die Tarifseiten folgen in den Phasen danach. Diese Seite beschreibt die Plattform, die gebaut wird, und sagt das, statt mehr anzudeuten.

Kann ich jetzt Zugangsdaten bekommen?

Über diese Seite noch nicht. Die Selbstregistrierung kommt mit dem Registrierungsablauf; bis dahin gibt SIDES Maschinenclient-Zugangsdaten direkt aus. Die Kontaktseite sagt, wie man fragt.

Wie ist die API dokumentiert?

Aus einer OpenAPI-Spezifikation, die vor den Handlern geschrieben und ausgeliefert wird unter /api/docs. Der Dienst verweigert den Start, wenn seine Routentabelle und die Spezifikation auseinandergehen — die Dokumentation kann also nicht still vom Code abdriften.

Gibt es eine Ratenbegrenzung?

Ja, je OAuth-Client und je Partnertarif. Antworten tragen X-RateLimit-Limit, X-RateLimit-Remaining und X-RateLimit-Reset für das Tagesbudget, und ein 429 trägt Retry-After. Behandeln Sie eine fehlende Kopfzeile als „nicht gezählt“, nie als erschöpftes Budget.

Welche Beschreibung passt zu Ihrem Unternehmen?

Anbindungspartner, Dienstleister oder Agentur — der Vertrag ist derselbe, der Ausgangspunkt nicht.

Anbindungspartner Dienstleister Agenturen