DU LÄSST EHER VON ETWAS AB, DAS GEDULD, MÜHE UND VERSTÄNDNIS ERFORDERT, ALS VON ETWAS, MIT DEM DU DEINE ZEIT NICHT VERSCHWENDEN SOLLTEST //
API
Wenn du die ÜBERSCHRIFTEN in deinem Projekt nutzen möchtest, wie zum Beispiel in einer App, auf deiner Website oder als Laufschrift irgendwo, dann kannst du sie (nicht nur) dafür komfortabel automatisiert unter anderem als JSON-Datei erhalten.
Übersicht
Die JSON-Datei
Du kannst den gesamten Katalog aller aktuell veröffentlichten ÜBERSCHRIFTEN herunterladen oder live abfragen:
https://ueberschriften.de/katalog.json
Das ist eine virtuelle Datei, die jede Veröffentlichung oder Aktualisierung automatisch widerspiegelt.
Neben ein paar Metadaten und den Nutzungsrechten beinhaltet es das Hauptitem items, in dem du als Array die ÜBERSCHRIFTEN selbst findest.
Die items beinhalten dabei die Nummer (nr) und die ÜBERSCHRIFT selbst (title).
Zufällige ÜBERSCHRIFT
Du kannst eine einzelne zufällige ÜBERSCHRIFT abrufen:
https://ueberschriften.de/katalog.json?zufall
Eine bestimmte ÜBERSCHRIFT
Eine bestimmte ÜBERSCHRIFT kannst du auch direkt abrufen:
https://ueberschriften.de/katalog.json?nr=38
Wobei 38 natürlich nur ein Beispiel für jede andere Nummer ist. Falls es sie nicht gibt, wird der Statuscode 404 zurück gegeben.
Weitere Funktionalität gewünscht?
Bei Bedarf baue ich die API gerne aus. Schreib mir.
Beispiel-Implementierung in JavaScript
Ein ganz einfaches Beispiel, wie du mit JavaScript eine zufällige ÜBERSCHRIFT für deine Website abrufen und nutzen kannst:
async function f() {
/* ruft eine zufällige ÜBERSCHRIFT ab */
const response =
await fetch('https://ueberschriften.de/katalog.json?zufall');
/* zum nutzen als Variable *
if (!response.ok) {
alert('Fehler. Bitte versuche es erneut.'); // Fehler
} else {
const body = await response.text(); // Antwort
var ueberschriften = JSON.parse(body); // Format
var ueberschrift = ueberschriften.ueberschriften.items[0]; // Objekt
/* zum Beispiel ein Element bestücken */
document.getElementById('spruchdestages').textContent =
"ÜBERSCHRIFT № " + ueberschrift.nr + ": " + ueberschrift.title;
}
}
Andere Endpunkte (CSV, Text, RSS-Feed)
Die ÜBERSCHRIFTEN kannst du auch in anderen Formaten erhalten:
CSV und Text
Einen ebenfalls immer aktuellen und vollständigen Katalog kannst du auch als nummerierte CSV und als Text-Datei bekommen:
https://ueberschriften.de/katalog.csv
https://ueberschriften.de/katalog.txt
Es gibt keine weiteren Parameter.
RSS-Feed
Der RSS-Feed der 20 neuesten ÜBERSCHRIFTEN, ideal für ein Widget auf deiner Website oder für die regelmäßige Inspiration in deinem Reader:
https://ueberschriften.de/katalog.rss
Eine einzelne, zufällige ÜBERSCHRIFT erhältst du durch:
https://ueberschriften.de/katalog.rss?zufall
Zeig her, was du daraus gemacht hast
Also: Mach die ÜBERSCHRIFTEN zu deinen und lass es mich gerne wissen.