Desarrolladores

Piloto automático

Configuración, próximos huecos y últimos resultados del piloto automático de un blog de Blogenia por API, con el permiso account:read.

Ver como Markdown

El piloto automático genera y publica artículos en los días y a la hora que eliges. Esta ruta de solo lectura devuelve su configuración, los próximos huecos y lo que pasó en los últimos.

Obtener el piloto automático

GET/blogs/{blogId}/autopilot

Configuración, próximos huecos y últimos resultados del piloto de un blog.

Parámetros de ruta

Nombre	Tipo	Obligatorio	Descripción
`blogId`	string	Sí	Identificador del blog.

Campos de la respuesta

Campo	Tipo	Descripción
`enabled`	boolean	`true` si el piloto está activado.
`mode`	string	`review` (los artículos esperan tu aprobación) o `auto` (se publican solos).
`scheduleType`	string	`weekly` (días fijos de la semana) o `interval` (cada cierto número de días).
`days`	array	Días de la semana de publicación, de 0 (domingo) a 6 (sábado). Vacío con `interval`.
`time`	string	Hora de publicación `HH:00`, en Europe/Madrid.
`nextSlots`	array	Hasta 10 próximos huecos: `[{ slotAt, status, topicTitle? }]`. `status` puede ser `planned`, `generating`, `pending_approval`, `scheduled`, `published`, `skipped`, `failed` o `missed`.
`lastSlots`	array	Hasta 10 últimos huecos: `[{ slotAt, result, articleId?, reason? }]`. `result` toma los mismos valores que `status`. `reason` explica un hueco saltado o fallido, por ejemplo `quota`, `no_topics`, `plan`, `suspended`, `missed`, `global_cap` o `generation_failed`.
`credits`	object	`{ perArticle, available }`: créditos que cuesta un artículo medio con los modelos del blog y créditos disponibles.

Respuestas

Código	Cuándo
`200`	Respuesta devuelta.
`404`	El blog no existe o es de otra organización.
`401`	Clave ausente, no válida o revocada.
`403`	La clave no tiene el permiso `account:read` (`code: "insufficient_scope"`), tu plan es Free (`plan_required`) o la organización está suspendida (`ORGANIZATION_SUSPENDED`).
`429`	Límite del plan superado. Ver Límites de uso.

Petición

curl "https://api.blogelia.com/v1/blogs/66f1c0a2b3c4d5e6f7a8b9c0/autopilot" \
  -H "Authorization: Bearer $BLOGENIA_API_KEY"

const res = await fetch('https://api.blogelia.com/v1/blogs/66f1c0a2b3c4d5e6f7a8b9c0/autopilot', {
  headers: { Authorization: 'Bearer ' + process.env.BLOGENIA_API_KEY },
});
if (!res.ok) throw new Error('HTTP ' + res.status);
const body = await res.json();
console.log(body);

import os
import requests

res = requests.get(
    "https://api.blogelia.com/v1/blogs/66f1c0a2b3c4d5e6f7a8b9c0/autopilot",
    headers={"Authorization": "Bearer " + os.environ["BLOGENIA_API_KEY"]},
    timeout=10,
)
res.raise_for_status()
print(res.json())

Respuesta

{
  "enabled": true,
  "mode": "review",
  "scheduleType": "weekly",
  "days": [1, 3],
  "time": "09:00",
  "nextSlots": [
    {
      "slotAt": "2026-11-05T08:00:00.000Z",
      "status": "generating",
      "topicTitle": "Cinco errores al reformar un baño"
    }
  ],
  "lastSlots": [
    {
      "slotAt": "2026-11-03T08:00:00.000Z",
      "result": "published",
      "articleId": "66f1c0a2b3c4d5e6f7a8b9c1"
    },
    { "slotAt": "2026-10-29T08:00:00.000Z", "result": "skipped", "reason": "no_topics" }
  ],
  "credits": { "perArticle": 8, "available": 940 }
}