Cómo integrarlo a tu proyecto

Autenticación

Tu API key

La API es de solo lectura. En cada petición envía la key de tu empresa:

• 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 embed muestra un spinner de carga mientras pide la API. Si integras solo con JSON (sin el kit), tú decides el loading en tu front. Las lecturas del detalle se acumulan en view_count y se ven en el panel de posts.

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" }
    }
  ],
  "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" }
  },
  "template": { "key": "classic", "name": "Classic", "config": {} }
}

Errores

Códigos habituales

{ "message": "Missing site_key. Send X-Site-Key header or site_key query param." }

{ "message": "Invalid or inactive site key." }

Respuesta estándar Laravel Not Found

Notas

Importante al integrar

• Solo posts con estado publicado salen en la API. Los borradores no.
• La API es de solo lectura: crear/editar posts se hace en el panel.
• Si recibes 401, revisa X-Site-Key o ?site_key= y que el sitio esté active.
• CORS: desde el navegador, tu dominio debe poder llamar a la API del panel.
• Plantillas del sitio (classic, magazine, minimal): vienen en template.key del JSON; el embed aplica la clase bp-{key}.
• per_page máximo es 50. Por defecto son 12.
• featured=1 o featured=true solo trae posts destacados.
• category=slug-de-categoria filtra el listado.
• Kit embed: ya incluye efecto de carga (spinner + texto). Si usas solo la API, el loading lo pones tú en tu front.
• Visualizaciones: cada GET /posts/{slug} suma 1 a view_count. El panel muestra el total en la lista y al editar el post.
• Demo local del embed: https://platform-mi-blog-listo.tinguar.com/embed/example.html