De platform-API

Niet gepubliceerd

De gehoste dienst heeft een HTTP-interface — daar praten de apps mee — maar het is geen gepubliceerde API. Er is geen openbaar document, geen gepubliceerde versie, en geen stabiliteitsbelofte. We beschrijven haar hier niet, omdat het beschrijven ervan een belofte zou suggereren om haar zo te houden.

En ze bevat niets van jou

Dat is de kleinere helft. De grotere is dat er helemaal geen gebruikersspecifieke routes op het platform zijn, en dat er geen plan is om die toe te voegen.

Een route die “wat is Mary’s code?” beantwoordt, zou het geheim nodig hebben dat de code oplevert, wat betekent dat de server het zou moeten bezitten. Vanaf dat moment is de end-to-end-belofte niet langer waar — niet door misbruik, maar door constructie: een server die je codes KAN lezen, is een server waarvan een compromittering ieders codes leest. Zorgvuldigheid aan onze kant verandert niet wat een aanvaller zou meenemen.

Dus wordt op geen enkele server die wij draaien een gebruikersgeheim opgeslagen. De interface van het platform is systeemniveauwerk tussen machines, dat geen persoonsgegeven raakt, en een accounthouder heeft er sowieso geen toegang toe.

Lees dat als de geruststelling die het bedoelt te zijn. De afwezigheid is geen functie waar we nog niet aan toe zijn gekomen. Het is de vorm van een systeem dat zo is ontworpen dat de slechtste dag aan onze kant niet de slechtste dag aan jouw kant is.

Wat je in plaats daarvan gebruikt

Draai de desktopcompanion en praat met zijn lokale API. De daemon bezit de sessie en de sleutels van het account, en bereikt het platform namens jou. Alles in deze sectie documenteert dat vlak.

Dit is de enige opzet waarin iets voor je account kan antwoorden: de sleutels staan op je machine, dus het antwoorden moet daar ook gebeuren.

Voor een server of een machineaccount zonder mens achter een scherm draait de companion headless en gelden dezelfde routes.

Wanneer dat verandert

Wordt de platform-API gepubliceerd, dan krijgt ze haar eigen pagina’s hier, naast de lokale, met dezelfde routekaart en dezelfde belofte over wat gegarandeerd is. Tot je die ziet, behandel de platforminterface als privé.

Wat niet verandert, is het bovenstaande: wat ook gepubliceerd wordt, blijft op systeemniveau, en bevat nog steeds geen geheim van jou.