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

Um 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âmetroPadrãoO que faz
limit10Quantos artigos devolver, de 1 a 100.
offset0Quantos 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

CampoSignificado
idO identificador do artigo.
titleO título do artigo.
contentO corpo do artigo em HTML (só num artigo).
descriptionA meta descrição.
languageO código de idioma do projeto, por exemplo en ou pt.
published_atA data de publicação, ou a de criação se não houver.
updated_atA última alteração.
pagination.total / has_moreQuantos artigos publicados existem e se há mais uma página.

Erros

StatusMensagemO 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.