Riferimento dell'API dei contenuti

L'API dei contenuti è in sola lettura. Restituisce in JSON gli articoli pubblicati del progetto a cui appartiene la tua chiave API, così il tuo sito li mostra nelle proprie pagine.

Endpoint

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

Un solo indirizzo per le due chiamate. Invia la chiave nell'header X-Rankfender-Key (vedi La tua chiave API). Vengono restituiti solo gli articoli con stato «pubblicato».

Elencare gli articoli

Senza id, l'API restituisce una pagina di articoli, dal più recente.

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 }
}

L'elenco dà per ogni articolo id, titolo, descrizione, lingua e date, senza il contenuto. Prendi l'id da qui per ottenere un articolo.

Ottenere un articolo

Con id, l'API restituisce quell'articolo con il contenuto completo in 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"
  }
}

Campi

Errori

Esempio in JavaScript

Chiama l'API da codice lato server, così la chiave non arriva mai nel browser dei visitatori.

// 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();