Referencia de la API de contenido
El endpoint public-article-api: listar artículos publicados con limit y offset, obtener uno por id, campos de respuesta y errores.
La API de contenido es de solo lectura. Devuelve en JSON los artículos publicados del proyecto al que pertenece tu clave de API, para que tu sitio los muestre en sus propias páginas.
Endpoint
GET https://odbowhcyfpzsifyibsdu.supabase.co/functions/v1/public-article-apiUna sola dirección para las dos llamadas. Envía tu clave en la cabecera X-Rankfender-Key (ver Tu clave de API). Solo se devuelven artículos con estado «publicado».
Listar tus artículos
Sin id, la API devuelve una página de artículos, del más reciente al más antiguo.
| Parámetro | Por defecto | Qué hace |
|---|---|---|
| limit | 10 | Cuántos artículos devolver, de 1 a 100. |
| offset | 0 | Cuántos artículos saltar. Úsalo con has_more para paginar. |
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 lista da de cada artículo su id, título, descripción, idioma y fechas, sin el contenido. Toma el id de aquí para pedir un artículo.
Obtener un artículo
Con id, la API devuelve ese artículo con su contenido completo 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"
}
}Campos
| Campo | Significado |
|---|---|
| id | El identificador del artículo. |
| title | El título del artículo. |
| content | El cuerpo del artículo en HTML (solo en un artículo). |
| description | La meta descripción. |
| language | El código de idioma del proyecto, por ejemplo en o es. |
| published_at | La fecha de publicación, o la de creación si no hay ninguna. |
| updated_at | El último cambio. |
| pagination.total / has_more | Cuántos artículos publicados hay y si sigue otra página. |
Errores
| Estado | Mensaje | Qué hacer |
|---|---|---|
| 401 | "API key required. Pass via X-Rankfender-Key header." | Añade la cabecera. |
| 401 | "Invalid API key" | Revisa la clave; genera una nueva si se sustituyó. |
| 404 | "Article not found or not published" | El id es incorrecto, pertenece a otro proyecto o el artículo no está publicado. |
| 500 | "Internal server error" | Vuelve a intentarlo; contacta con soporte si continúa. |
Ejemplo en JavaScript
Llama a la API desde código de servidor para que la clave nunca llegue al navegador de los visitantes.
// 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();Nota
El ejemplo «Direct API» de la tarjeta es el que debes copiar. Sus ejemplos de Next.js, React, Vue e iframe cargan un script que no está disponible: usa llamadas HTTP simples como las de esta página.