Obtener el token público
El token público es la única credencial de esta API. Identifica a una tienda y habilita la lectura de su contenido.
ndp_pub_a3f9k2mX7pLqR2wNDe dónde sale
Sección titulada «De dónde sale»Lo genera la app y lo ve el comerciante en el panel de Sectionfy. Si estás desarrollando un tema para un cliente, pídeselo al comerciante: es él quien lo tiene a mano.
Un token pertenece a una tienda. No hay tokens globales ni tokens que abarquen varias tiendas.
Cómo se usa
Sección titulada «Cómo se usa»Va como un segmento del path, siempre inmediatamente después de la raíz del recurso:
https://sectionfy.codefy-apps.com/api/public/content/{token}/{page} ^^^^^^^No va en un header Authorization, ni en un query param, ni en una cookie.
Si lo envías en un header, la petición falla igual que si no lo hubieras enviado.
Qué puede y qué no puede
Sección titulada «Qué puede y qué no puede»| Puede | Leer el contenido publicado de esa tienda. |
| No puede | Escribir, borrar, ni modificar nada. |
| No puede | Acceder a datos de otra tienda. |
| No puede | Acceder a datos de clientes, pedidos, ni a nada de la cuenta de Tiendanube. |
Es un token de lectura de contenido de marketing. El peor escenario si se filtra es que alguien lea el contenido que de todos modos es visible en la tienda.
Ponerlo en el código de un tema
Sección titulada «Ponerlo en el código de un tema»El token va a terminar en el JavaScript del tema, que es público. Eso está contemplado en el diseño: por eso el token es opaco y de solo lectura.
Aun así, la forma recomendada es declararlo como un setting del tema en vez de hardcodearlo, para que el comerciante lo pegue y lo pueda rotar sin tocar código:
[ { "name": "Sectionfy", "settings": [ { "name": "sectionfy_token", "title": "Token público de Sectionfy", "type": "text" } ] }]Y en el template, con un fallback por si el setting aún no está cargado:
<script> window.SECTIONFY_TOKEN = '{{ settings.sectionfy_token }}' || 'ndp_pub_...';</script>Validar que funciona
Sección titulada «Validar que funciona»La forma más rápida es una llamada a la home de la tienda, que no necesita ningún identificador extra:
curl -i https://sectionfy.codefy-apps.com/api/public/content/TU_TOKEN/home-page200con un cuerpo JSON → el token es válido.400 token has invalid format→ el token está mal escrito. Se rechaza por forma, antes de buscarlo.401→ el formato es válido pero el token no corresponde a ninguna tienda.
Los códigos completos están en errores, y puedes probarlo sin escribir código en el probador.
