Páginas

Una página es una sección de contenido dentro de la tienda donde se muestra información importante sobre el negocio. Ejemplos comunes incluyen: Quiénes somos, Cómo comprar o Preguntas frecuentes.

---

Propiedades

Propiedad	Descripción
id	Identificador único de la página
title	Título de la página
handle	URL de la página
content	Contenido HTML
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
type_page_status_id	Estado (1 = publicada, 2 = borrador)

---

Endpoints

GET /pages

Obtiene una lista de páginas.

Parámetros de query

Parámetro	Descripción
ids	Lista de IDs separados por comas
q	Buscar por título o handle
page	Número de página
per_page	Cantidad de resultados por página
handle	Buscar por handle exacto

Ejemplo

GET /pages

HTTP/1.1 200 OK

{
  "pagination": {
    "total": 120,
    "page": 1,
    "per_page": 50,
    "next_page": "https://developers.tiendanegocio.com/v1/pages?page=2&per_page=50"
  },
  "results": [
    {
      "id": 41,
      "title": "Mi página",
      "handle": "mi-pagina",
      "content": "<h1>example</h1>\n<p>pagina</p>",
      "created_at": "2026-03-26T14:42:55.000Z",
      "updated_at": "2026-03-26T14:42:55.000Z",
      "seo_title": "Mi página",
      "seo_description": "Mi página",
      "file_cover_id": 11,
      "type_page_status_id": 1
    }
  ]
}

---

GET /pages/{id}

Obtiene una página por ID.

Ejemplo

GET /pages/41

HTTP/1.1 200 OK

{
  "id": 41,
  "title": "Mi página",
  "handle": "mi-pagina",
  "content": "<h1>example</h1>\n<p>pagina</p>",
  "created_at": "2026-03-26T14:42:55.000Z",
  "updated_at": "2026-03-26T14:42:55.000Z",
  "seo_title": "Mi página",
  "seo_description": "Mi página",
  "file_cover_id": 11,
  "type_page_status_id": 1
}

---

POST /pages

Crea una nueva página.

Ejemplo de request

{
  "title": { "es": "Mi página" },
  "handle": { "es": "mi-pagina" },
  "content": "<h1>Bienvenido</h1>",
  "seo_title": { "es": "Mi SEO" },
  "seo_description": { "es": "Descripción SEO" },
  "published": 1,
  "thumbnail": "data:image/webp;base64,${base64}"
}

Respuesta

HTTP/1.1 201 Created

{
  "id": 50,
  "title": "Mi página",
  "handle": "mi-pagina",
  "content": "<h1>Bienvenido</h1>",
  "seo_title": "Mi SEO",
  "seo_description": "Descripción SEO",
  "file_cover_id": 23,
  "type_page_status_id": 1
}

---

PUT /pages/{id}

Actualiza una página existente.

Ejemplo

PUT /pages/50

{
  "title": { "es": "Página editada" },
  "handle": { "es": "mi-pagina" },
  "content": "<h1>Bienvenido</h1>",
  "seo_title": { "es": "Mi SEO" },
  "seo_description": { "es": "Descripción SEO" },
  "published": 1,
  "thumbnail": "data:image/webp;base64,${base64}"
}

Respuesta

HTTP/1.1 200 OK

{
  "id": 50,
  "title": "Página editada",
  "handle": "mi-pagina",
  "content": "<h1>Bienvenido</h1>",
  "seo_title": "Mi SEO",
  "seo_description": "Descripción SEO",
  "file_cover_id": 23,
  "type_page_status_id": 1,
  "updated_at": "2026-04-10T13:22:38.000Z"
}

---

DELETE /pages/{id}

Elimina una página.

Ejemplo

DELETE /pages/50

HTTP/1.1 200 OK

{
  "message": "Page deleted successfully"
}