Référence de l'API de contenu
Le point d'accès public-article-api : lister les articles publiés avec limit et offset, en récupérer un par id, champs et erreurs.
L'API de contenu est en lecture seule. Elle renvoie en JSON les articles publiés du projet auquel appartient votre clé d'API, pour que votre site les affiche sur ses propres pages.
Point d'accès
GET https://odbowhcyfpzsifyibsdu.supabase.co/functions/v1/public-article-apiUne seule adresse pour les deux appels. Envoyez votre clé dans l'en-tête X-Rankfender-Key (voir Votre clé d'API). Seuls les articles au statut « publié » sont renvoyés.
Lister vos articles
Sans id, l'API renvoie une page d'articles, du plus récent au plus ancien.
| Paramètre | Par défaut | Rôle |
|---|---|---|
| limit | 10 | Nombre d'articles renvoyés, de 1 à 100. |
| offset | 0 | Nombre d'articles à sauter. À combiner avec has_more pour paginer. |
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 }
}La liste donne pour chaque article son id, son titre, sa description, sa langue et ses dates, sans le contenu. Prenez l'id ici pour récupérer un article.
Récupérer un article
Avec id, l'API renvoie cet article avec son contenu complet en 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"
}
}Champs
| Champ | Signification |
|---|---|
| id | L'identifiant de l'article. |
| title | Le titre de l'article. |
| content | Le corps de l'article en HTML (article seul uniquement). |
| description | La méta-description. |
| language | Le code de langue du projet, par exemple en ou fr. |
| published_at | La date de publication, ou la date de création si aucune n'est définie. |
| updated_at | La dernière modification. |
| pagination.total / has_more | Le nombre d'articles publiés, et s'il reste une page. |
Erreurs
| Statut | Message | Que faire |
|---|---|---|
| 401 | "API key required. Pass via X-Rankfender-Key header." | Ajoutez l'en-tête. |
| 401 | "Invalid API key" | Vérifiez la clé ; générez-en une nouvelle si elle a été remplacée. |
| 404 | "Article not found or not published" | L'id est faux, appartient à un autre projet, ou l'article n'est pas publié. |
| 500 | "Internal server error" | Réessayez ; contactez le support si cela persiste. |
Exemple en JavaScript
Appelez l'API depuis du code serveur pour que la clé n'arrive jamais dans le navigateur des visiteurs.
// 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();À savoir
L'exemple « Direct API » de la carte est celui à copier. Ses exemples Next.js, React, Vue et iframe chargent un script qui n'est pas disponible : utilisez des appels HTTP simples comme ceux de cette page.