Guía Rápida de la API

Comenzando con la API de BlogFlux

Aprende cómo integrar BlogFlux en tus aplicaciones usando nuestra REST API.

🔑 Paso 1: Obtén tu Clave API

1. Inicia sesión en tu panel de BlogFlux
2. Ve a Configuración > Claves API
3. Haz clic en "Generar Nueva Clave API"
4. Copia y guarda tu clave de forma segura

⚠️ Advertencia de Seguridad

¡Nunca expongas tu clave API en código del lado del cliente o repositorios públicos!

📡 URL Base

https://blogflux.ai/api/v1

🔐 Autenticación

Incluye tu clave API en el encabezado Authorization:

Authorization: Bearer TU_CLAVE_API

📝 Ejemplo: Generar una Publicación

cURL

curl -X POST https://blogflux.ai/api/v1/posts/generate \
  -H "Authorization: Bearer TU_CLAVE_API" \
  -H "Content-Type: application/json" \
  -d '{
    "topic": "Cómo entrenar un golden retriever",
    "ai_model": "gpt-5-mini",
    "language": "es"
  }'

Python

import requests

url = "https://blogflux.ai/api/v1/posts/generate"
headers = {
    "Authorization": "Bearer TU_CLAVE_API",
    "Content-Type": "application/json"
}
data = {
    "topic": "Cómo entrenar un golden retriever",
    "ai_model": "gpt-5-mini",
    "language": "es"
}

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 TU_CLAVE_API',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    topic: 'Cómo entrenar un golden retriever',
    ai_model: 'gpt-5-mini',
    language: 'es'
  })
};

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

✅ Formato de Respuesta

{
  "status": "success",
  "data": {
    "post_id": "abc123",
    "title": "Cómo Entrenar un Golden Retriever: Guía Completa",
    "content": "...",
    "status": "completed"
  }
}

🔍 Códigos de Error

Código	Significado	Solución
400	Solicitud Incorrecta	Verifica tus parámetros
401	No Autorizado	Verifica tu clave API
429	Límite de Tasa	Espera antes de reintentar
500	Error del Servidor	Contacta con soporte

📚 Próximos Pasos

Para referencia completa de la API con todos los endpoints, parámetros y ejemplos disponibles, visita nuestra documentación interactiva:

📖 Documentación Completa de la API (Swagger UI)