API
Ortszeit hat eine REST-API. Sie wurde für die mobilen Apps gebaut — die Offline-Warteschlange, die Foto-Uploads, der Kontingentstand, den sie anzeigen, bevor du an ein Limit stößt — und sie ist heute erreichbar.
Sie ist noch keine stabile öffentliche API. Endpunkte und Payloads ändern sich mit den Apps, ohne Übergangsfrist, weil die einzigen Clients von uns kommen. Bau ruhig dagegen, aber häng nichts daran fest, dessen Bruch dich ärgern würde. Die Schnittstelle, die ein Vertrag ist, ist das portable Format — das hat ein Versionsfeld und einen dokumentierten Deprecation-Pfad, und dort stehen die Zusagen mit Absicht.
Schema
Das OpenAPI-Schema wird aus dem Code erzeugt und liegt unter:
https://accounts.ortszeit.app/api/schema/Dieses Dokument ist die Referenz. Was auf dieser Seite dazu im Widerspruch steht, ist veraltet.
Authentifizierung
Zwei Wege hinein:
-
Ein API-Schlüssel, als Header geschickt:
Authorization: Api-Key <your-key> -
Ein Session-Cookie, das ist der Weg, den der Web-Editor selbst nimmt.
Alles ist auf den einen Blog der angemeldeten Person beschränkt. Es gibt keinen
kontoübergreifenden Zugriff, und es gibt keine öffentliche Lese-API für fremde
Blogs — veröffentlichte Blogs sind ohnehin öffentliches HTML, mit RSS unter
/feed/ und JSON Feed unter /feed.json, und das ist die richtige
Schnittstelle, um die Texte anderer Leute zu lesen.
Grob, was es gibt
Reisen, Beiträge, Medien-Upload, Ortssuche und -bestätigung, das Ende-der-Reise-
Fenster, den Kontingentstand sowie die Jobs für Export und
Import. Abweisungen wegen eines Limits kommen als 403
zurück, mit einer für Menschen lesbaren Meldung, die das erreichte Limit
benennt — ein Client kann sie also anzeigen, ohne sich eigene Formulierungen
auszudenken.
Für die tatsächlichen Pfade, Parameter und Formen sieh ins Schema.
Keine API in die andere Richtung
Ortszeit postet nicht in deinem Namen auf Instagram, TikTok, YouTube oder Google Maps, und das wird auch nicht kommen. Teilen läuft über das Teilen-Menü deines Telefons: Das kostet einen zusätzlichen Tipp, funktioniert mit allem, was auf dem Gerät installiert ist, und geht nicht kaputt, wenn eine Plattform ihre Regeln ändert.