Documentación · v1

Bienvenido a redacta +

Un blog editorial embebible para tu sitio, publicando desde un panel simple y consumiendo una API JSON privada desde tu propio servidor.

redacta + te da un blog que vive en tu dominio, con SEO real y datos estructurados, sin que tengas que montar un CMS. El contenido se administra en el panel de Axobit y se publica en tu sitio mediante una API REST de solo lectura, protegida por una llave privada por proyecto que se consume en servidor (nunca llega al navegador).

Esta documentación cubre la integración actual (server-side), la referencia completa de la API y el roadmap del widget por script tag que está en camino.

Conceptos clave

Antes de integrar, conviene conocer estas piezas:

La llave privada de cada blog se genera en el panel y solo se almacena su hash SHA-256 — ni siquiera el panel puede volver a mostrarla después de crearla.

Autenticación

Todos los endpoints requieren una llave de API válida. Se envía en el encabezado Authorization con esquema Bearer:

Authorization: Bearer rda_tu_llave_privada_de_proyecto

Obtener tu llave

1. Entra al panel de Axobit

   Inicia sesión y abre la sección redacta +.

2. Selecciona (o crea) tu blog

   Cada proyecto tiene su propio blog y su propia llave.

3. Genera / copia la llave

   Se muestra una sola vez al crearla. Guárdala en un lugar seguro: tu servidor o variables de entorno.

Tu cliente es responsable de mantener la llave en un solo archivo de configuración del lado del servidor (ver Kit de cliente).

Inicio rápido

Este ejemplo hace una llamada completa y muestra la portada del blog en tu página. Sustituye TU_LLAVE por tu llave privada.

1. Trae la configuración del blog

$ch = curl_init('https://axobit.mx/bknd/archivosPHP/redactaApi.php?endpoint=config');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ['Authorization: Bearer ' . 'TU_LLAVE'],
]);
$resp = json_decode(curl_exec($ch), true);
curl_close($ch);

2. Trae el listado de artículos

$url = 'https://axobit.mx/bknd/archivosPHP/redactaApi.php?endpoint=listado&porPagina=12';
$ch = curl_init($url);
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ['Authorization: Bearer ' . 'TU_LLAVE'],
]);
$resp = json_decode(curl_exec($ch), true);
curl_close($ch);

// $resp['data']['articulos'] = lista de artículos;
// $resp['data']['paginacion'] = { pagina, porPagina, total, paginas }

3. Renderiza las tarjetas

Con los datos del listado, arma tu portada con HTML y descripcionSeo para SEO. Cada artículo trae titulo, slug, url, resumen, categoria, portada y más.

Kit de cliente reutilizable

Para no reinventar la rueda, proveemos un kit base con la portada y la vista de artículo listas para copiar. Vive en axobit.mx/redacta-kit/ y se replica por proyecto (cliente de referencia: creditoautosnuevosyseminuevos.com).

Archivos del kit

Configuración en un solo archivo

// Al inicio del archivo -- única fuente de verdad
define('REDACTA_BLOG_URL', 'https://tusitio.com');      // portada (raíz)
define('REDACTA_SITIO_URL', 'https://tusitio.com');     // marca / schema
define('REDACTA_TITULAR',   'Tu Marca');
define('REDACTA_API_URL',  'https://axobit.mx/bknd/archivosPHP/redactaApi.php');
define('REDACTA_LLAVE',    'rda_tu_llave');             // secreto

Los helpers (r_api(), r_esc(), r_head(), r_footer(), r_hojaEstilo(), r_cuerpo(), r_espacioPublicidad()) centralizan el cURL y el render, de modo que index.php y articulo.php solo arman HTML.

Referencia

Resumen de la API

URL base (server-to-server, en Axobit):

https://axobit.mx/bknd/archivosPHP/redactaApi.php

Cada endpoint usa el parámetro de query endpoint (alias resource). Todos son solo lectura GET. La API es sin CORS y debe consumirse en servidor.

Respuesta estándar de éxito:

{ "ok" : true, "data": { // … según el endpoint } }

En caso de error, el cuerpo siempre es:

{ "ok": false, "error": { "code": "codigo", "message": "mensaje" } }

config

Devuelve la configuración general del blog y sus categorías activas. Es el primer endpoint a llamar para obtener urlBase, urlImagenes y el mapa de rutas.

$ch = curl_init('https://axobit.mx/bknd/archivosPHP/redactaApi.php?endpoint=config');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ['Authorization: Bearer ' . 'TU_LLAVE'],
]);
$data = json_decode(curl_exec($ch), true)['data'];

Respuesta

{
  "ok": true,
  "data": {
    "blog": {
      "id": 7,
      "titulo": "Blog de ejemplo",
      "descripcion": "Un blog de demostración",
      "idioma": "es",
      "urlBase": "https://tusitio.com",
      "urlImagenes": "https://axobit.mx/ftnd/graficos/blogs/7/"
    },
    "categorias": [
      { "id": 1, "nombre": "Diario", "slug": "diario", "orden": 1 }
    ],
    "urls": {
      "config": "?endpoint=config",
      "categorias": "?endpoint=categorias",
      "listado": "?endpoint=listado",
      "detalle": "?endpoint=detalle&slug={slug}"
    }
  }
}

categorias

Devuelve solo las categorías activas del blog, ordenadas por orden. Útil para construir un selector o un menú de filtros.

$ch = curl_init('https://axobit.mx/bknd/archivosPHP/redactaApi.php?endpoint=categorias');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ['Authorization: Bearer ' . 'TU_LLAVE'],
]);
$data = json_decode(curl_exec($ch), true)['data'];

Respuesta

{
  "ok": true,
  "data": {
    "categorias": [
      { "id": 1, "nombre": "Diario", "slug": "diario", "orden": 1 },
      { "id": 2, "nombre": "Tutoriales", "slug": "tutoriales", "orden": 2 }
    ]
  }
}

listado

Devuelve los artículos publicados con paginación, ordenados por fecha de publicación descendente. Es el endpoint de la portada.

Parámetros de query

$url = 'https://axobit.mx/bknd/archivosPHP/redactaApi.php'
      . '?endpoint=listado&categoria=tutoriales&pagina=1&porPagina=6';
$ch = curl_init($url);
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ['Authorization: Bearer ' . 'TU_LLAVE'],
]);
$data = json_decode(curl_exec($ch), true)['data'];

// $data['articulos']   -> array de artículos (resumen, sin cuerpo)
// $data['paginacion']  -> { pagina, porPagina, total, paginas }

Respuesta

{
  "ok": true,
  "data": {
    "articulos": [ { "idArticulo": 4, "titulo": "…", "portada": { … } } ],
    "paginacion": { "pagina": 1, "porPagina": 6, "total": 23, "paginas": 4 }
  }
}

Cada artículo del listado usa el molde de artículo (sin el campo cuerpo).

detalle

Devuelve un artículo completo por slug. Es el único endpoint que incluye el cuerpo tipado y las imágenes de cuerpo. Además registra una vista (dedupe diario por IP + UA + fecha).

Parámetros de query

$slug = 'el-caso-por-la-simplicidad';
$url = 'https://axobit.mx/bknd/archivosPHP/redactaApi.php?endpoint=detalle&slug=' . urlencode($slug);
$ch = curl_init($url);
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ['Authorization: Bearer ' . 'TU_LLAVE'],
]);
$data = json_decode(curl_exec($ch), true)['data'];
$articulo = $data['articulo'];

Respuesta

Además del molde de artículo, el detalle agrega:

{
  "ok": true,
  "data": {
    "articulo": {
      # …molde de artículo…
      "cuerpo": [
        { "tipo": "p",   "html": "<p>…</p>" },
        { "tipo": "img", "url": "https://…/cuerpo.jpg", "alt": "Ilustración" },
        { "tipo": "p",   "html": "<p>…</p>" }
      ],
      "cuerpoImagenes": [ { "url": "…", "alt": "…", "ancho": 1280, "alto": 720 } ]
    }
  }
}

El campo cuerpo es una lista tipada de bloques que tu plantilla debe recorrer: renderiza html para los de tipo p y <img> para los de tipo img. Es ideal para insertar banners publicitarios entre párrafos (el kit lo hace con r_espacioPublicidad()).

Objetos de la API

Artículo (molde)

Bloque de cuerpo

Imagen (portada / cuerpo)

Paginación

Operaciones

Códigos de error

Los errores siempre devuelven el mismo contenedor JSON y un código estable para que tu cliente pueda reaccionar de forma programática.

Ejemplo de respuesta de error

{
  "ok": false,
  "error": {
    "code": "unauthorized",
    "message": "Se requiere una llave de proyecto."
  }
}

Rate limits

Cada llave puede hacer hasta 180 peticiones por minuto, contadas por llave + IP de origen.

• Si superas el límite, la API responde 429 con código rate_limited y la cabecera Retry-After: 60.
• La ventana se reinicia cada minuto (por hora UTC + minuto).
• 180/min es holgado para un uso típico de blog. Aplica cache del lado del cliente para evitar llamadas repetidas en cada visita.

Seguridad

• Sin CORS: la API solo responde GET y no habilita CORS, así que no puede consumirse desde el navegador de un cliente. Se usa desde tu backend.
• Llaves con hash: solo se almacena el hash SHA-256 de cada llave. La llave real se muestra una vez al crearla.
• Bloqueo de la API: en el despliegue del cliente, el .htaccess bloquea ^api/redacta\.php$ para que la API pública nunca se exponga en el dominio del cliente.
• HTTPS forzado: el dominio sirve solo por HTTPS; redirige www y HTTP a la versión canónica.
• Sanitización: todo el HTML de contenido se escapa/limpia en servidor antes de devolverse al cliente.

Rendimiento

• Render en servidor: arma el HTML en tu backend; el navegador recibe HTML listo e indexable. Este es el enfoque recomendado y el actual.
• Imágenes WebP optimizadas: el panel optimiza las subidas a WebP y devuelve dimensiones (ancho/alto) para evitar cambios de layout (CLS).
• Tipografía variable: Fraunces + Inter con display=swap, sin bloqueo de render.
• Datos estructurados: la portada y el artículo emiten JSON-LD (Blog, BlogPosting, BreadcrumbList) para SEO.

Roadmap

Widget por script tag (próximamente)

Estamos preparando un embed por script tag para quienes quieren blog sin tocar backend. Con una sola etiqueta puedes montar la portada en tu HTML; la versión actual y recomendada sigue siendo la API server-side.

<!-- 1. El contenedor donde quieres el blog -->
<div id="redacta-blog"></div>

<!-- 2. El widget -->
<script src="https://axobit.mx/redacta+/embed.js"
        data-project="pk_live_xxxxx"
        data-mount="#redacta-blog"></script>

Más

Changelog

• v1.0

  API pública inicial

  Endpoints config, categorias, listado y detalle; autenticación Bearer por llave privada; rate limit de 180/min; cuerpo tipado por bloques; registro de visitas con dedupe.

• ago-2026

  Simplificación del kit de cliente

  El blog se instala en la raíz del dominio. Config centralizada en constantes REDACTA_* en redacta-cliente.php (ya no existe redacta.config.php); hoja de estilos uii.css. Kit base en redacta-kit/.

• próximamente

  Widget por script tag

  Embed de la portada sin backend. Detalles al liberarse.

Soporte

¿Necesitas ayuda para integrar o hay algo que no cuadra con la documentación?

• Panel de Axobit: crea o configura tu blog en la sección redacta +.
• Cliente de referencia: creditoautosnuevosyseminuevos.com (kit en redacta-kit/).
• Guía interna: redacta-plus.md / documentacion.md del proyecto Axobit.