Cómo integrarlo a tu proyecto

Autenticación

Tu API key

Autenticación de la API pública con site key. Lectura de contenido + POST de newsletter y comentarios.

• Header recomendado: X-Site-Key: TU_SITE_KEY
• Query alternativa: ?site_key=TU_SITE_KEY
• Base actual: https://platform-mi-blog-listo.tinguar.com/api/v1

La key la obtienes al crear tu cuenta o empresa en el panel. En los ejemplos usa TU_SITE_KEY hasta copiar la tuya.

Kit embed

BlogPlatform.create

Archivos públicos del panel: https://platform-mi-blog-listo.tinguar.com/embed/blog-templates.css y https://platform-mi-blog-listo.tinguar.com/embed/blog-client.js. Ideal si quieres listado + detalle sin armar el front desde cero.

Opciones de create()

El kit incluye spinner, búsqueda, filtros, paginación, lightbox, compartir, tema oscuro, progreso de lectura, newsletter y comentarios con respuestas anidadas según settings. Las vistas del detalle (y UTM de la URL) se registran en el panel.

Métodos que devuelve

Detalle con query: /blog?slug=mi-primer-post → bootFromQuery() carga el artículo. Demo: https://platform-mi-blog-listo.tinguar.com/embed/example.html

Contrato JSON

Ejemplos de respuesta

Forma típica de GET /posts y GET /posts/{slug}.

{
  "data": [
    {
      "title": "Mi primer post",
      "subtitle": null,
      "slug": "mi-primer-post",
      "excerpt": "Resumen…",
      "cover_image": "https://…/cover.jpg",
      "cover_layout": "below",
      "cover_size": "full",
      "is_featured": false,
      "view_count": 42,
      "reading_minutes": 3,
      "published_at": "2026-08-10T12:00:00+00:00",
      "published_label": "10 ago 2026",
      "author": { "name": "Ana" },
      "category": { "name": "Noticias", "slug": "noticias" },
      "tags": [{ "name": "Guías", "slug": "guias" }]
    }
  ],
  "meta": {
    "current_page": 1,
    "last_page": 1,
    "per_page": 12,
    "total": 1,
    "stats": { "articles": 1, "categories": 1, "featured": 0 }
  },
  "template": { "key": "classic", "name": "Classic", "config": {} }
}

{
  "data": {
    "title": "Mi primer post",
    "slug": "mi-primer-post",
    "excerpt": "Resumen…",
    "content": "<p>HTML del artículo…</p>",
    "meta_title": "Mi primer post",
    "meta_description": "Resumen…",
    "cover_image": "https://…/cover.jpg",
    "view_count": 43,
    "author": { "name": "Ana" },
    "category": { "name": "Noticias", "slug": "noticias" },
    "tags": [{ "name": "Guías", "slug": "guias" }],
    "related": [{ "title": "Otro post", "slug": "otro-post" }],
    "comments": [{
      "id": 12,
      "parent_id": null,
      "depth": 0,
      "author_name": "Luis",
      "body": "Muy útil",
      "is_featured": false,
      "staff_label": null,
      "created_label": "hace 2 horas",
      "replies": [{
        "id": 15,
        "parent_id": 12,
        "depth": 1,
        "author_name": "Ana",
        "body": "¡Gracias!",
        "is_featured": false,
        "staff_label": "Autor",
        "created_label": "hace 1 hora",
        "replies": []
      }]
    }]
  },
  "settings": {
    "newsletter_enabled": true,
    "comments_enabled": true,
    "blog_show_hero": true
  },
  "template": { "key": "classic", "name": "Classic", "config": {} }
}

Panel

Funciones del CMS

Lo que configuras en el panel afecta la API y el embed.

• Contenido

  • Categorías, tags, destacados y búsqueda pública (?q=).
  • Publicación programada con published_at (solo visibles cuando llega la fecha).
  • Autosave, revisiones y biblioteca de medios con compresión de imágenes.
  • Hero del embed editable u ocultable en Empresa → Ajustes.

• Engagement

  • Newsletter y comentarios (moderación opcional) desde Ajustes.
  • Respuestas anidadas en el blog (hasta 4 niveles) y favoritos destacados.
  • Panel → Comentarios: hilos por artículo, aprobar/ocultar/favorito/responder y marcar leídos.
  • RSS y sitemap para SEO.
  • Embed: modo oscuro, progreso de lectura, compartir, lightbox con swipe/pinch.

• Seguridad y equipo

  • Invitar writers por correo (enlace 7 días) desde Escritores.
  • Dueño ve todos los comentarios; escritor solo los de sus posts. Respuestas del equipo con badge público.
  • 2FA TOTP desde Perfil → Autenticación 2FA.
  • Audit log de acciones clave (posts, ajustes, API key, invites, 2FA).

• Analítica

  • Vistas totales y diarias en el dashboard.
  • Únicos (7 días) y top fuentes UTM cuando el detalle se abre con ?utm_*.
  • El embed reenvía UTM de la URL de la página al GET /posts/{slug}.

Notas

Importante al integrar

• Solo posts publicados con published_at ≤ ahora salen en la API. Borradores y programados no.
• Lectura pública: GET con site key. Escritura pública limitada: newsletter y comentarios (POST).
• Crear/editar posts, invites y 2FA se hacen en el panel (sesión autenticada).
• Si recibes 401, revisa X-Site-Key o ?site_key= y que el sitio esté active.
• Listados GET usan caché corta + ETag. El detalle /posts/{slug} no se cachea para medir vistas.
• Rate limit: ~120 req/min lectura y ~20/min escritura por sitio+IP.
• CORS: desde el navegador, tu dominio debe poder llamar a la API del panel.
• Plantillas (classic, magazine, minimal): vienen en template.key; el embed aplica bp-{key}.
• per_page máximo es 50. Por defecto son 12.
• Filtros: featured, category, tag, q. Paginación: page.
• UTM: pasa ?utm_source=… en la URL del blog; el embed los manda al detalle.
• feed.xml y sitemap.xml necesitan base_url apuntando a la URL pública de tu /blog.
• Si tu página ya tiene título (ej. “Noticias”), oculta el hero del embed en Empresa → Ajustes.
• Comentarios: POST con parent_id para responder (máx. 4 niveles). Modera y marca leídos en panel → Comentarios.
• Demo local del embed: https://platform-mi-blog-listo.tinguar.com/embed/example.html