Skip to content
Zenit Studio Zenit Scent

Uso de la API pública

Mont Blanc · Everest

La API pública permite construir storefronts e integraciones que consumen el catálogo. Olympus no incluye API keys propias; Mont Blanc y Everest admiten hasta cinco, gestionadas con el equipo de plataforma.

URL base

Section titled “URL base”

Producción:

https://api-scent.zenitstudio.dev/api/public/v1

Utiliza únicamente rutas bajo /api/public/v1. Las variantes sin esa base o con versiones duplicadas no forman parte del contrato canónico.

Autenticación

Section titled “Autenticación”

Envía la clave en el encabezado x-api-key:

Terminal window
curl 'https://api-scent.zenitstudio.dev/api/public/v1/products' \
  -H 'x-api-key: TU_API_KEY'

Nunca incluyas una clave privada en un repositorio público. Para storefronts ejecutados en el navegador, coordina con soporte el mecanismo de acceso apropiado y restringe el origen permitido.

Flujo recomendado

Section titled “Flujo recomendado”
  1. Obtén la clave correspondiente al tenant.
  2. Consulta tenant-info para cargar la configuración y capacidades disponibles.
  3. Consume marcas, productos, facetas y ofertas desde las rutas canónicas.
  4. Envía eventos de búsqueda y compra solo cuando el usuario realice la acción.
  5. Usa checkout y estado de orden respetando el esquema publicado.

Contrato interactivo

Section titled “Contrato interactivo”

Consulta la referencia OpenAPI para ver parámetros, cuerpos y respuestas vigentes. El contrato se genera directamente desde las rutas públicas del SaaS.