Ir al contenido

Qué es esta API

Sectionfy es una app de Tiendanube donde el comerciante arma contenido enriquecido para las páginas de su tienda: preguntas frecuentes, carruseles de imágenes, fichas de especificaciones, banners promocionales.

Esta API expone ese contenido para que un tema custom lo renderice a su manera. La app no impone HTML ni estilos: te devuelve datos y tú decides cómo se ven.

Para quien escribe el código de un tema de Tiendanube y necesita mostrar el contenido que el comerciante cargó, sin acoplarse al panel de la app.

No necesitas una cuenta de desarrollador, ni registrar una app, ni pasar por OAuth. Necesitas una sola cosa: el token público de la tienda.

Una llamada devuelve el conjunto completo de secciones configuradas para una página concreta: la ficha de un producto, la de una categoría, la home, o la plantilla general de todos los productos.

{
"page": "product",
"product_id": "333333174",
"sections": { "…": "una entrada por sección configurada" }
}

Dentro de sections conviven tipos distintos. Un producto puede tener a la vez un FAQ, un carrusel y un banner; todos llegan en la misma respuesta.

Vale la pena ser explícito, porque ahorra tiempo buscando:

No haceEn su lugar
Escribir contenidoLa API es de solo lectura. El contenido se carga desde el panel de la app.
Devolver HTML renderizadoDevuelve JSON. El markup lo pones tú.
Filtrar por tipo de secciónDevuelve todos los tipos de una página; filtras en el cliente.
PaginarLas respuestas son completas. products/all devuelve todos los productos con contenido.
Buscar o consultar por atributosNo hay query params de filtrado. El path determina la respuesta entera.
Decidir qué mostrarDevuelve secciones ocultas y archivadas también. La regla de render es tuya y es obligatoria — ver la estructura de la respuesta.
  • Solo GET. No hay verbos de escritura públicos.
  • Sin headers de autenticación. El token va en el path.
  • Sin bodies. Ni de request ni en verbos alternativos.
  • JSON siempre. Content-Type: application/json.
  • Cacheable. Respeta Cache-Control y ETag — ver cache.

Es deliberadamente aburrida: se consume con un fetch() de una línea desde el navegador, sin SDK ni build step.

Obtener el token público de la tienda con la que trabajarás.