Referenz der Content-API │ Rankfender Docs

Die Content-API ist schreibgeschützt. Sie liefert die veröffentlichten Artikel des Projekts, dem Ihr API-Schlüssel gehört, als JSON, damit Ihre Website sie auf eigenen Seiten zeigt.

Endpunkt

GET https://odbowhcyfpzsifyibsdu.supabase.co/functions/v1/public-article-api

Eine Adresse für beide Aufrufe. Senden Sie Ihren Schlüssel im Header X-Rankfender-Key (siehe Ihr API-Schlüssel). Nur Artikel mit dem Status „veröffentlicht“ werden geliefert.

Artikel auflisten

Ohne id liefert die API eine Seite mit Artikeln, die neuesten zuerst.

Parameter	Standard	Was er bewirkt
limit	10	Wie viele Artikel geliefert werden, von 1 bis 100.
offset	0	Wie viele Artikel übersprungen werden. Zusammen mit has_more zum Blättern.

curl "https://odbowhcyfpzsifyibsdu.supabase.co/functions/v1/public-article-api?limit=10&offset=0" \
  -H "X-Rankfender-Key: rfk_your_key"

{
  "success": true,
  "articles": [
    {
      "id": "8c1f…",
      "title": "…",
      "description": "…",
      "language": "en",
      "published_at": "2026-10-14T09:12:00Z",
      "updated_at": "2026-10-14T09:30:00Z"
    }
  ],
  "pagination": { "limit": 10, "offset": 0, "count": 1, "total": 1, "has_more": false }
}

Die Liste nennt für jeden Artikel id, Titel, Beschreibung, Sprache und Daten, ohne den Inhalt. Die id von hier nutzen Sie, um einen Artikel abzurufen.

Einen Artikel abrufen

Mit id liefert die API diesen Artikel mit dem vollständigen Inhalt als HTML.

curl "https://odbowhcyfpzsifyibsdu.supabase.co/functions/v1/public-article-api?id=ARTICLE_ID" \
  -H "X-Rankfender-Key: rfk_your_key"

{
  "success": true,
  "article": {
    "id": "8c1f…",
    "title": "…",
    "content": "<h2>…</h2><p>…</p>",
    "description": "…",
    "language": "en",
    "published_at": "2026-10-14T09:12:00Z",
    "updated_at": "2026-10-14T09:30:00Z"
  }
}

Felder

Feld	Bedeutung
id	Die Kennung des Artikels.
title	Der Titel des Artikels.
content	Der Artikeltext als HTML (nur beim einzelnen Artikel).
description	Die Meta-Beschreibung.
language	Der Sprachcode des Projekts, zum Beispiel en oder de.
published_at	Das Veröffentlichungsdatum, sonst das Erstellungsdatum.
updated_at	Die letzte Änderung.
pagination.total / has_more	Wie viele veröffentlichte Artikel es gibt und ob eine weitere Seite folgt.

Fehler

Status	Meldung	Was tun
401	"API key required. Pass via X-Rankfender-Key header."	Header hinzufügen.
401	"Invalid API key"	Schlüssel prüfen; einen neuen erzeugen, falls er ersetzt wurde.
404	"Article not found or not published"	Die id ist falsch, gehört zu einem anderen Projekt oder der Artikel ist nicht veröffentlicht.
500	"Internal server error"	Erneut versuchen; bei Wiederholung den Support kontaktieren.

Beispiel in JavaScript

Rufen Sie die API aus serverseitigem Code auf, damit der Schlüssel nie im Browser der Besucher landet.

// Server-side code (Node 18+, Next.js server component, etc.)
const res = await fetch(
  "https://odbowhcyfpzsifyibsdu.supabase.co/functions/v1/public-article-api?limit=10",
  { headers: { "X-Rankfender-Key": process.env.RANKFENDER_KEY } }
);
const { articles, pagination } = await res.json();

Hinweis

Kopieren Sie das Beispiel „Direct API“ der Karte. Ihre Beispiele für Next.js, React, Vue und iframe laden ein Skript, das nicht verfügbar ist: nutzen Sie einfache HTTP-Aufrufe wie auf dieser Seite.