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 quién es
Sección titulada «Para quién es»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.
Qué devuelve
Sección titulada «Qué devuelve»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.
Qué NO hace
Sección titulada «Qué NO hace»Vale la pena ser explícito, porque ahorra tiempo buscando:
| No hace | En su lugar |
|---|---|
| Escribir contenido | La API es de solo lectura. El contenido se carga desde el panel de la app. |
| Devolver HTML renderizado | Devuelve JSON. El markup lo pones tú. |
| Filtrar por tipo de sección | Devuelve todos los tipos de una página; filtras en el cliente. |
| Paginar | Las respuestas son completas. products/all devuelve todos los productos con contenido. |
| Buscar o consultar por atributos | No hay query params de filtrado. El path determina la respuesta entera. |
| Decidir qué mostrar | Devuelve secciones ocultas y archivadas también. La regla de render es tuya y es obligatoria — ver la estructura de la respuesta. |
Forma de la API
Sección titulada «Forma de la API»- 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-ControlyETag— ver cache.
Es deliberadamente aburrida: se consume con un fetch() de una línea desde el
navegador, sin SDK ni build step.
Siguiente paso
Sección titulada «Siguiente paso»Obtener el token público de la tienda con la que trabajarás.
