VERWECHSLE MITGEFÜHL NICHT MIT EMPATHIE //
Schnittstelle
Mach sie zu deinen! 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 das gesamte Verzeichnis aller aktuell veröffentlichten ÜBERSCHRIFTEN herunterladen oder live abfragen:
https://ueberschriften.xyz/verzeichnis.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), so wie die den entsprechenden Permalink (url).
Zufällige ÜBERSCHRIFT
Du kannst eine einzelne zufällige ÜBERSCHRIFT abrufen:
https://ueberschriften.xyz/verzeichnis.json?zufall
Eine bestimmte ÜBERSCHRIFT
Eine bestimmte ÜBERSCHRIFT kannst du auch direkt abrufen:
https://ueberschriften.xyz/verzeichnis.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 Schnittstelle 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() {
try {
const response = await fetch('https://ueberschriften.xyz/verzeichnis.json?zufall');
if (!response.ok) {
throw new Error('Fehler. Bitte versuche es erneut.');
}
const body = await response.text();
let ueberschriften;
try {
ueberschriften = JSON.parse(body);
} catch (error) {
throw new Error('Fehler beim Parsen der JSON-Daten.');
}
if (ueberschriften && ueberschriften.ueberschriften && ueberschriften.ueberschriften.items && ueberschriften.ueberschriften.items.length > 0) {
var ueberschrift = ueberschriften.ueberschriften.items[0];
document.querySelector('#spruchdestages').textContent =
"ÜBERSCHRIFT № " + ueberschrift.nr + ": " + ueberschrift.title;
} else {
throw new Error('Ungültige JSON-Daten.');
}
} catch (error) {
alert(error.message);
}
}
Andere Endpunkte (CSV, Text, RSS-Feed)
Die ÜBERSCHRIFTEN kannst du auch in anderen Formaten erhalten:
CSV und Text
Ein ebenfalls immer aktuelles und vollständiges Verzeichnis kannst du auch als nummerierte CSV und als Text-Datei bekommen:
https://ueberschriften.xyz/verzeichnis.csv
https://ueberschriften.xyz/verzeichnis.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.xyz/verzeichnis.rss
Eine einzelne, zufällige ÜBERSCHRIFT erhältst du durch:
https://ueberschriften.xyz/verzeichnis.rss?zufall
Zeig her, was du daraus gemacht hast
Also: Mach die ÜBERSCHRIFTEN zu deinen und lass es mich gerne wissen.