Blogs

Un blog es una sección de tu tienda donde podés publicar artículos informativos sobre tu negocio. Algunos ejemplos comunes son: Quiénes somos, Cómo comprar o Preguntas frecuentes.

---

Propiedades

Propiedad	Descripción
id	Identificador único del artículo
title	Título del artículo
handle	URL del artículo
content	Contenido HTML del artículo
created_at	Fecha de creación (ISO 8601)
updated_at	Fecha de última actualización (ISO 8601)
seo_title	Título utilizado para SEO
seo_description	Descripción utilizada para SEO
file_cover_id	ID de la imagen de portada
summary	Breve descripción del artículo
type_page_status_id	Estado (1 = publicado, 2 = borrador)

---

Endpoints

GET /blogs

Obtiene una lista de artículos del blog.

Ejemplo

GET /blogs

HTTP/1.1 200 OK

{
  "pagination": {
    "total": 120,
    "page": 1,
    "per_page": 50,
    "next_page": "https://developers.tiendanegocio.com/v1/blogs?page=2&per_page=50"
  },
  "results": [
    {
      "id": 15,
      "title": "Preguntas frecuentes",
      "handle": "preguntas-frecuentes",
      "summary": "Respuestas a las consultas sobre la tienda.",
      "content": "<h1>Hola</h1>",
      "created_at": "2026-03-26T14:42:55.000Z",
      "updated_at": "2026-03-26T14:42:55.000Z",
      "seo_title": "Preguntas frecuentes",
      "seo_description": "Preguntas frecuentes",
      "file_cover_id": 12,
      "type_page_status_id": 1
    }
  ]
}

---

GET /blogs/{id}

Obtiene un artículo de blog por ID.

Ejemplo

GET /blogs/15

HTTP/1.1 200 OK

{
  "id": 15,
  "title": "Preguntas frecuentes",
  "handle": "preguntas-frecuentes",
  "summary": "Respuestas a las consultas sobre compras, envíos y funcionamiento de la tienda.",
  "content": "<h1>Hola</h1>",
  "created_at": "2026-03-26T14:42:55.000Z",
  "updated_at": "2026-03-26T14:42:55.000Z",
  "seo_title": "Preguntas frecuentes",
  "seo_description": "Preguntas frecuentes",
  "file_cover_id": 12,
  "type_page_status_id": 1
}

---

POST /blogs

Crea un nuevo artículo de blog.

Ejemplo de request

{
  "title": { "es": "Quiénes somos" },
  "handle": { "es": "quienes-somos" },
  "content": "<h1>Bienvenido</h1>",
  "seo_title": { "es": "Quiénes somos" },
  "seo_description": { "es": "Quiénes somos" },
  "published": 1,
  "summary": {
    "es": "Somos un equipo comprometido en brindar productos de calidad y una experiencia de compra simple, confiable y cercana para nuestros clientes"
  },
  "thumbnail": "data:image/webp;base64,${base64}"
}

Respuesta

HTTP/1.1 201 OK

{
  "id": 16,
  "title": "Quiénes somos",
  "handle": "quienes-somos",
  "content": "<h1>Bienvenido</h1>",
  "seo_title": "Quiénes somos",
  "seo_description": "Quiénes somos",
  "file_cover_id": 13,
  "summary": "Somos un equipo comprometido en brindar productos de calidad y una experiencia de compra simple, confiable y cercana para nuestros clientes",
  "type_page_status_id": 1
}

---

PUT /blogs/{id}

Actualiza un artículo de blog existente.

Ejemplo

PUT /blogs/16

{
  "id": 16,
  "title": { "es": "Sobre nosotros" },
  "handle": { "es": "sobre-nosotros" },
  "summary": {
    "es": "Somos un equipo comprometido en brindar productos de calidad."
  },
  "content": "<h1>Bienvenido</h1>",
  "seo_title": { "es": "Quiénes somos" },
  "seo_description": { "es": "Quiénes somos" },
  "published": 1,
  "thumbnail": "data:image/webp;base64,${base64}"
}

Respuesta

HTTP/1.1 200 OK

{
  "title": { "es": "Quiénes somos" },
  "handle": { "es": "quienes-somos" },
  "summary": "Somos un equipo comprometido en brindar productos de calidad.",
  "content": "<h1>Bienvenido</h1>",
  "seo_title": { "es": "Quiénes somos" },
  "seo_description": { "es": "Quiénes somos" },
  "type_page_status_id": 1,
  "thumbnail": "data:image/webp;base64,${base64}"
}

---

DELETE /blogs/{id}

Elimina un artículo de blog.

Ejemplo

DELETE /blogs/16