Ir al contenido

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_a3f9k2mX7pLqR2wN

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.

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.

PuedeLeer el contenido publicado de esa tienda.
No puedeEscribir, borrar, ni modificar nada.
No puedeAcceder a datos de otra tienda.
No puedeAcceder 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.

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:

config/settings.txt
[
{
"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:

snipplets/sectionfy.tpl
<script>
window.SECTIONFY_TOKEN = '{{ settings.sectionfy_token }}' || 'ndp_pub_...';
</script>

La forma más rápida es una llamada a la home de la tienda, que no necesita ningún identificador extra:

Ventana de terminal
curl -i https://sectionfy.codefy-apps.com/api/public/content/TU_TOKEN/home-page
  • 200 con 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.

Tu primera llamada.