A API pública do DraftIn

O DraftIn é um CMS headless para quem escreve. Você modela o conteúdo, escreve no editor e publica — e a API pública entrega esse conteúdo já publicado para qualquer front-end: um site em Astro ou Next.js, um app nativo, uma newsletter ou um webhook de revalidação.

Esta é a referência oficial da camada pública da plataforma: a interface de leitura de conteúdo que os sites dos clientes consomem usando uma chave de API. Toda a documentação a seguir cobre apenas os endpoints destinados ao consumo por aplicações de terceiros — nada da administração interna do painel.

Em 30 segundos

Toda requisição aponta para a base URL de produção e leva sua chave no header X-API-Key. Veja como listar os três posts mais recentes de um blog:

curl https://api.draftin.io/public/posts?limit=3 \
  -H "X-API-Key: $DRAFTIN_API_KEY"

const res = await fetch("https://api.draftin.io/public/posts?limit=3", {
  headers: { "X-API-Key": process.env.DRAFTIN_API_KEY },
});

const { data: posts } = await res.json();
console.log(posts);

A resposta é um envelope JSON { success, data }, com o array de objetos Post em data. A partir daí, renderize como quiser — O DraftIn não impõe tema nem camada de apresentação.

Por onde começar

Se é a sua primeira integração, siga este caminho:

Princípios da API

• REST sobre HTTPS. Caminhos previsíveis, verbos HTTP padrão e respostas JSON.
• Escopo por blog. Cada chave de API pertence a um blog e só enxerga o conteúdo daquele blog.
• Somente conteúdo publicado. Os endpoints públicos retornam apenas itens com status PUBLISHED — rascunhos e agendados nunca vazam.
• Sem estado de sessão. Não há login nem cookies: a autenticação é por chave em cada requisição.
• Respostas em envelope. Sucessos vêm como { success, data, meta? } e erros como { success: false, error } com código estável — veja Formato das respostas.