Die Plattform-API

Nicht veröffentlicht

Der gehostete Dienst hat eine HTTP-Schnittstelle — mit ihr sprechen die Apps —, aber sie ist keine veröffentlichte API. Es gibt kein öffentliches Dokument, keine veröffentlichte Version und kein Stabilitätsversprechen. Wir beschreiben sie hier nicht, weil eine Beschreibung ein Versprechen andeuten würde, sie so zu erhalten.

Und sie enthält nichts von dir

Das ist die kleinere Hälfte. Die größere ist, dass es überhaupt keine nutzerspezifischen Routen auf der Plattform gibt, und dass keine geplant sind.

Eine Route, die “Wie lautet Marias Code?” beantworten würde, bräuchte das Geheimnis, das den Code erzeugt, was bedeutet, dass der Server es halten müsste. Von diesem Moment an stimmt das Ende-zu-Ende-Versprechen nicht mehr — nicht durch Missbrauch, sondern schon durch den Aufbau: Ein Server, der deine Codes lesen KANN, ist ein Server, dessen Kompromittierung die Codes von allen liest. Sorgfalt auf unserer Seite ändert nichts daran, was ein Angreifer mitnehmen würde.

Deshalb wird auf keinem Server, den wir betreiben, ein Nutzergeheimnis gespeichert. Die Schnittstelle der Plattform ist systemseitige Arbeit von Maschine zu Maschine, die keine persönlichen Daten berührt, und ein Kontoinhaber hat ohnehin keinen Zugriff darauf.

Lies das als die Zusicherung, die es sein soll. Das Fehlen ist kein Merkmal, das wir noch nicht umgesetzt haben. Es ist die Form eines Systems, das so gebaut ist, dass der schlechteste Tag bei uns nicht der schlechteste Tag bei dir ist.

Was du stattdessen verwendest

Führe das Desktop-Begleitprogramm aus und sprich mit seiner lokalen API. Der Dienst hält Sitzung und Schlüssel des Kontos und erreicht die Plattform in deinem Namen. Alles in diesem Abschnitt dokumentiert diese Oberfläche.

Das ist die einzige Anordnung, in der überhaupt etwas für dein Konto antworten kann: Die Schlüssel liegen auf deiner Maschine, also muss das Antworten auch dort geschehen.

Für einen Server oder ein Maschinenkonto ohne Person am Bildschirm läuft das Begleitprogramm ohne Oberfläche, und dieselben Routen gelten.

Wenn sich das ändert

Sollte die Plattform-API veröffentlicht werden, bekommt sie eigene Seiten hier, neben der lokalen, mit derselben Routenübersicht und derselben Zusicherung. Bis du sie siehst, behandle die Schnittstelle der Plattform als privat.

Was sich nicht ändern wird, ist der Teil oben: Was auch immer veröffentlicht wird, ist systemseitig und wird weiterhin kein Geheimnis von dir enthalten.