DFDH API
Mach DFDH zu deinem! Wenn du die Denkanstöße in deinem Projekt nutzen möchtest, wie zum Beispiel in einer App, auf deiner Website oder als Laufschrift irgendwo, dann kannst du DFDH (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 Denkanstöße herunterladen oder live abfragen:
https://dfdh.studio/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 Denkanstöße selbst findest.
Die items beinhalten dabei die Nummer (nr) und den Denkanstoß selbst (text), so wie die den entsprechenden Permalink (url).
Zufälliger Denkanstoß
Du kannst einen einzelnen zufälligen Denkanstoß abrufen:
https://dfdh.studio/verzeichnis.json?zufall
Ein bestimmter Denkanstoß
Einen bestimmten Denkanstoß kannst du auch direkt abrufen:
https://dfdh.studio/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 einen zufälligen Denkanstoß für deine Website abrufen und nutzen kannst:
async function f() {
try {
const response = await fetch("https://dfdh.studio/verzeichnis.json?zufall");
if (!response.ok) {
throw new Error("Fehler. Bitte versuche es erneut.");
}
const body = await response.text();
let dfdh;
try {
dfdh = JSON.parse(body);
} catch (error) {
throw new Error("Fehler beim Parsen der JSON-Daten.");
}
if (dfdh && dfdh.dfdh && dfdh.dfdh.items && dfdh.dfdh.items.length > 0) {
var text = dfdh.dfdh.items[0];
document.querySelector("#spruchdestages").textContent =
"DFDH Nr. " + dfdh.nr + ": " + dfdh.text;
} else {
throw new Error("Ungültige JSON-Daten.");
}
} catch (error) {
alert(error.message);
}
}
Andere Endpunkte (CSV, Text, RSS-Feed)
DFDH 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://dfdh.studio/verzeichnis.csv
https://dfdh.studio/verzeichnis.txt
Es gibt keine weiteren Parameter.
RSS-Feed
Der RSS-Feed der 20 neuesten Denkanstöße, ideal für ein Widget auf deiner Website oder für die regelmäßige Inspiration in deinem Reader:
https://dfdh.studio/verzeichnis.rss
Einen einzelne, zufälligen Denkanstoß erhältst du durch:
https://dfdh.studio/verzeichnis.rss?zufall
Zeig her, was du daraus gemacht hast
Also: Mach DFDH zu deinem und lass es mich gerne wissen.