Introducción

Qué necesitas

Una tienda en La Vitrina. El catálogo, los precios y las entregas se manejan desde el dashboard.

La credencial de tu tienda. En el dashboard, entra a Desarrollador y pulsa Generar credencial. Solo el dueño de la tienda ve esa sección. Recibes:

Dato	Para qué
`Client ID (servidor de tu sitio)`	`sf-…`: con él y el secreto, tu servidor pide el token de la tienda.
`Client secret`	Se muestra una sola vez. Guárdalo en tu servidor.
`Client ID (login de clientes)`	`sf-…-login`: con él tus clientes inician sesión en tu sitio.

Las direcciones de regreso de tu sitio, por ejemplo https://mitienda.com/callback. Se escriben en la misma sección; el inicio de sesión de tus clientes solo vuelve a esas direcciones.

Dirección base

Todas las rutas de esta documentación cuelgan de:

https://api.lavitrina-online.com/api/storefront

Por ejemplo, GET /storefront/items se llama en https://api.lavitrina-online.com/api/storefront/items. Solo se admite HTTPS. Estas rutas aceptan llamadas desde cualquier dominio (CORS abierto), porque se identifican con tokens y no con cookies.

Formato

Las peticiones con cuerpo (POST) se envían en JSON, con la cabecera Content-Type: application/json.
Las respuestas siempre son JSON.
Los nombres de los campos van en PascalCase: PriceInCents, ShortDescription, StoreId.
Las fechas con hora usan el formato ISO 8601, por ejemplo 2026-10-21T16:41:53.427Z.

Dinero

Los precios son números enteros en centavos, en campos que terminan en InCents. Un producto de 49.900 pesos llega como 4990000. La moneda de la tienda (COP o USD) viaja aparte, en Currency.

Qué verbos se usan

Verbo	Para qué
`GET`	Consultar datos. No cambia nada.
`POST`	Crear algo (un cliente, una tarjeta, una compra).