Guia Rápido da API

Começando com a API do BlogFlux

Aprenda como integrar o BlogFlux em suas aplicações usando nossa REST API.

🔑 Passo 1: Obtenha sua Chave API

1. Faça login no seu dashboard do BlogFlux
2. Vá em Configurações > Chaves API
3. Clique em "Gerar Nova Chave API"
4. Copie e salve sua chave com segurança

⚠️ Aviso de Segurança

Nunca exponha sua chave API em código client-side ou repositórios públicos!

📡 URL Base

https://blogflux.ai/api/v1

🔐 Autenticação

Inclua sua chave API no cabeçalho Authorization:

Authorization: Bearer SUA_CHAVE_API

📝 Exemplo: Gerar um Post

cURL

curl -X POST https://blogflux.ai/api/v1/posts/generate \
  -H "Authorization: Bearer SUA_CHAVE_API" \
  -H "Content-Type: application/json" \
  -d '{
    "topic": "Como adestrar um golden retriever",
    "ai_model": "gpt-5-mini",
    "language": "pt-BR"
  }'

Python

import requests

url = "https://blogflux.ai/api/v1/posts/generate"
headers = {
    "Authorization": "Bearer SUA_CHAVE_API",
    "Content-Type": "application/json"
}
data = {
    "topic": "Como adestrar um golden retriever",
    "ai_model": "gpt-5-mini",
    "language": "pt-BR"
}

response = requests.post(url, headers=headers, json=data)
print(response.json())

JavaScript (Node.js)

const fetch = require('node-fetch');

const url = 'https://blogflux.ai/api/v1/posts/generate';
const options = {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer SUA_CHAVE_API',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    topic: 'Como adestrar um golden retriever',
    ai_model: 'gpt-5-mini',
    language: 'pt-BR'
  })
};

fetch(url, options)
  .then(res => res.json())
  .then(data => console.log(data));

✅ Formato da Resposta

{
  "status": "success",
  "data": {
    "post_id": "abc123",
    "title": "Como Adestrar um Golden Retriever: Guia Completo",
    "content": "...",
    "status": "completed"
  }
}

🔍 Códigos de Erro

Código	Significado	Solução
400	Requisição Inválida	Verifique seus parâmetros
401	Não Autorizado	Verifique sua chave API
429	Limite de Taxa	Aguarde antes de tentar novamente
500	Erro do Servidor	Contate o suporte

📚 Próximos Passos

Para referência completa da API com todos os endpoints, parâmetros e exemplos disponíveis, visite nossa documentação interativa:

📖 Documentação Completa da API (Swagger UI)