Entwickler-Blog
Notizen aus dem API-Team
Warum die Plattform so geschnitten ist, wie sie ist, was eine Entscheidung gekostet hat, und wie man die Teile benutzt, die nicht offensichtlich sind. Geschrieben für die Entwickler, die gegen SIDES integrieren — nicht für eine Pressemitteilung.
Die Beiträge
Alles bisher Veröffentlichte
Dargestellt aus GET /v1/publication/public/blog-posts, neueste zuerst. Ein Beitrag, der für ein künftiges Datum geplant ist, steht nicht hier und ist auch über seinen Link nicht erreichbar — das Datum wird dort durchgesetzt, wo es zählt: auf dem Server.
Noch nichts veröffentlicht
Bisher wurde kein Artikel veröffentlicht. Ein Beitrag mit künftigem Datum erscheint erst, wenn dieses Datum erreicht ist.
Über diese Beiträge
Was dieser Blog ist und was er nicht ist
- Die Autoren bauen die Plattform selbst
- Jeder Beitrag nennt seinen Autor. Was Sie hier lesen, ist, wie die Plattform tatsächlich funktioniert, einschließlich der unbequemen Teile — eine Entwurfsnotiz, die nur die gute Hälfte beschriebe, wäre die Lesezeit nicht wert, die sie beansprucht.
- Er ist nicht das Changelog
- Eine Änderung an der API wird festgehalten im Changelog, mit Version, Datum und den berührten Endpunkten. Dieser Blog erklärt; das Changelog hält fest. Wenn Sie wissen müssen, ob etwas kaputtgegangen ist, ist das Changelog die Seite, die antwortet.
- Er ist auch nicht die Referenz
- Jeder Endpunkt, Parameter und Fehler steht in der API-Referenz — seit sie kein öffentliches Dokument mehr ist, im Partnerportal, und für alle zusammengefasst auf der Entwicklerseite. Sie wird aus derselben Spezifikation erzeugt, an der sich der Server selbst misst. Ein Beitrag kann zeigen, wie man drei Endpunkte zusammen benutzt; er wird nie zur zweiten Beschreibung eines einzelnen.
- Kategorien und Schlagworte sind die Ablage
- Jeder Beitrag trägt eine Kategorie und beliebig viele Schlagworte. Beide sind Links: Einem zu folgen fragt die API nach diesem Kürzel, statt diese Seite im Browser einzugrenzen — das Ergebnis ist also eine echte Seite, die Sie als Lesezeichen speichern und teilen können.
Lesen ist die billige Hälfte
Die Registrierung legt Ihren Geschäftspartner, Ihren ersten Administrator und Ihr Abonnement in einem Schritt an — und die API ist dieselbe, um die es in jedem Beitrag hier geht.
