Freigegebene Artikel direkt ins CMS, in einem Format für alles.
Die Ausgabe-API liefert jeden freigegebenen Artikel als JSON mit Text-Blöcken, HTML oder Markdown, vom Morgenformat bis zur Analyse. Mit Abgleich nach Änderungszeit, Swagger-Doku und Schlüsselschutz.
Das kannst du damit machen
- Alle freigegebenen Artikel abrufen, gefiltert nach Format, Formatfamilie, Symbol, ISIN und Zeitraum.
- Nur Änderungen seit dem letzten Abruf holen und zurückgenommene Artikel erkennen, um sie zu depublizieren.
- Den Text als strukturierte Blöcke, als HTML oder als Markdown bekommen, Kurs-Widgets und Instrumente inklusive.
- Bilder in der passenden Breite anfordern, mit Bildnachweis und Alternativtext.
- Die Doku als Swagger-Seite an Entwickler weitergeben und dort direkt ausprobieren.
- In der Vorschau sehen, was ein Abnehmer bekommt, ohne Schlüssel.
- Als Admin Schlüssel mit Bezeichnung erzeugen und einzeln widerrufen. Ein neuer Schlüssel wird genau einmal angezeigt.
Das haben wir uns dabei gedacht
Die erste Fassung kannte nur Fließtext. Ein gegliedertes Format wie die DAX-Vorbörse kam leer an, Tabellen gar nicht. Statt für jedes Format einen eigenen Endpunkt zu bauen, gibt es jetzt einen Vertrag: Jeder Artikel ist eine Folge von Blöcken, und das abnehmende System entscheidet, ob es Blöcke, HTML oder Markdown will.
Ein CMS fragt nicht „gib mir alles“, sondern „was hat sich seit eben geändert?“. Deshalb blättert die API über einen Cursor nach Änderungszeit, und zurückgenommene Artikel bleiben als solche sichtbar, damit sie auch auf der Webseite verschwinden.
Nach außen geht bewusst nur Lesen, über eigene, schlanke Felder statt der internen Dokumente. So bleibt der Vertrag stabil, auch wenn sich innen etwas ändert.
Ein CMS fragt nicht „gib mir alles“, sondern „was hat sich seit eben geändert?“
Verbesserungen
Schlüssel erzeugen statt eintippen
In den Einstellungen erzeugst du einen Schlüssel mit Bezeichnung und kopierst ihn direkt, denn er wird nur dieses eine Mal angezeigt. Die Liste zeigt Bezeichnung, Anfang des Schlüssels und Anlagedatum, jeder Schlüssel lässt sich einzeln widerrufen.
Version 1 liefert nur freigegebene Artikel
Auch die ältere Version 1 gibt News erst nach der Freigabe aus, zurückgenommene fehlen in Liste und Detail. Analysen, die die Nachprüfung markiert hat, stehen nicht mehr in ihrer Liste. Die News-Liste nennt das Instrument mit Name und ISIN wie das Detail.
Die Einstellungen beschreiben Version 2
Der Reiter „Externe API“ führt mit Basis-URL, Swagger-Link und Beispielaufruf durch Version 2. Version 1 steht als Altversion daneben, für Termine, Earnings und Directors-Dealings, die es nur dort gibt.
Swagger-Doku hinter dem Produktionspfad
„Try it out“ in der Swagger-Doku funktioniert auch hinter dem Pfad, unter dem die Produktion läuft.
Zeitraum und Formatfilter
Zeitraum mit Datum, Uhrzeit oder Unix-Zeit. Formate und Familien lassen sich ein- und ausschließen. Die Swagger-Doku ist auch in Produktion erreichbar.
Schlüssel als URL-Parameter
Der Schlüssel geht auch als URL-Parameter, für einen schnellen Test im Browser.
Ausgabe-API v2
Ein Format für alle Artikel, Freigabezustand, Abgleich nach Änderungszeit und eine Vorschau in der App.
Artikel mit Archivbild
Artikel kommen mit passendem Archivbild in wählbarer Breite, samt Bildnachweis und Alternativtext.
Feedback geben oder Rückfragen stellen
Fehlt etwas, stört etwas, ist etwas unklar? Schreib es hier auf — die Nachricht landet direkt bei den Menschen, die an diesem Feature arbeiten.
Oder direkt hier schreiben: