Referência da API de conteúdo
O endpoint public-article-api: listar artigos publicados com limit e offset, obter um por id, campos da resposta e erros.
A API de conteúdo é só de leitura. Devolve em JSON os artigos publicados do projeto a que pertence a sua chave de API, para o seu site os mostrar nas próprias páginas.
Endpoint
GET https://odbowhcyfpzsifyibsdu.supabase.co/functions/v1/public-article-apiUm só endereço para as duas chamadas. Envie a chave no cabeçalho X-Rankfender-Key (ver A sua chave de API). Só são devolvidos artigos com o status «publicado».
Listar os seus artigos
Sem id, a API devolve uma página de artigos, do mais recente para o mais antigo.
| Parâmetro | Padrão | O que faz |
|---|---|---|
| limit | 10 | Quantos artigos devolver, de 1 a 100. |
| offset | 0 | Quantos artigos saltar. Use com 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 }
}A lista dá de cada artigo o id, título, descrição, idioma e datas, sem o conteúdo. Use o id daqui para pedir um artigo.
Obter um artigo
Com id, a API devolve esse artigo com o conteúdo completo em 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 | O identificador do artigo. |
| title | O título do artigo. |
| content | O corpo do artigo em HTML (só num artigo). |
| description | A meta descrição. |
| language | O código de idioma do projeto, por exemplo en ou pt. |
| published_at | A data de publicação, ou a de criação se não houver. |
| updated_at | A última alteração. |
| pagination.total / has_more | Quantos artigos publicados existem e se há mais uma página. |
Erros
| Status | Mensagem | O que fazer |
|---|---|---|
| 401 | "API key required. Pass via X-Rankfender-Key header." | Adicione o cabeçalho. |
| 401 | "Invalid API key" | Verifique a chave; gere uma nova se tiver sido substituída. |
| 404 | "Article not found or not published" | O id está errado, pertence a outro projeto ou o artigo não está publicado. |
| 500 | "Internal server error" | Tente de novo; contacte o suporte se continuar. |
Exemplo em JavaScript
Chame a API a partir de código no servidor, para a chave nunca chegar ao navegador dos 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
O exemplo «Direct API» do cartão é o que deve copiar. Os exemplos de Next.js, React, Vue e iframe carregam um script que não está disponível: use chamadas HTTP simples como as desta página.