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
• Andere Endpunkte (CSV, Text, RSS-Feed)
• Zeig her, was du daraus gemacht hast

Die JSON-Datei

Du kannst das gesamte Verzeichnis aller aktuell veröffentlichten ÜBERSCHRIFTEN herunterladen oder live abfragen:

https://überschriften.co/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://überschriften.co/verzeichnis.json?zufall

Eine bestimmte ÜBERSCHRIFT

Eine bestimmte ÜBERSCHRIFT kannst du auch direkt abrufen:

https://überschriften.co/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://überschriften.co/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 Nr. " + 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://überschriften.co/verzeichnis.csv
https://überschriften.co/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://überschriften.co/verzeichnis.rss

Eine einzelne, zufällige ÜBERSCHRIFT erhältst du durch:

https://überschriften.co/verzeichnis.rss?zufall

Zeig her, was du daraus gemacht hast

Also: Mach die ÜBERSCHRIFTEN zu deinen und lass es mich gerne wissen.