Saltearse al contenido

Referencia API

Endpoints de la Public API comercial, parámetros y ejemplos curl — generados desde el contrato OpenAPI.

Todos los endpoints requieren la cabecera X-API-Key. Base URL de producción: https://api.shishapp.es

Descargar OpenAPI

Autenticación

Envía tu API key comercial en cada petición:

X-API-Key: ska_v1_…_…
GET /api/public/v1/brands

List brands (.basic)

brand

Returns all tobacco brands in the catalog.

Capability
catalog.brands.read .basic Starter+

Parámetros

Sin parámetros.

Respuestas

  • 200 — Default Response
  • 401 — Default Response
  • 402 — Default Response
  • 403 — Default Response
  • 429 — Default Response
  • 500 — Default Response

Ejemplo

curl -s -H "X-API-Key: $API_KEY" \
  "https://api.shishapp.es/api/public/v1/brands"
GET /api/public/v1/brands/{brandId}/tobaccos

List tobaccos by brand (.basic)

tobacco

Returns tobacco products for a brand (basic product fields).

Capability
catalog.tobaccos.basic.read .basic Starter+

Parámetros

Nombre En Tipo Descripción
brandId path string · uuid Brand UUID obligatorio

Respuestas

  • 200 — Default Response
  • 400 — Default Response
  • 401 — Default Response
  • 402 — Default Response
  • 403 — Default Response
  • 404 — Default Response
  • 429 — Default Response
  • 500 — Default Response

Ejemplo

curl -s -H "X-API-Key: $API_KEY" \
  "https://api.shishapp.es/api/public/v1/brands/00000000-0000-0000-0000-000000000001/tobaccos"
GET /api/public/v1/flavors

List flavor tags (.enriched)

flavors

Returns all flavor tags.

Capability
catalog.flavors.read .enriched Pro / Business

Parámetros

Sin parámetros.

Respuestas

  • 200 — Default Response
  • 401 — Default Response
  • 402 — Default Response
  • 403 — Default Response
  • 429 — Default Response
  • 500 — Default Response

Ejemplo

curl -s -H "X-API-Key: $API_KEY" \
  "https://api.shishapp.es/api/public/v1/flavors"
GET /api/public/v1/tobaccos/search

Search tobaccos (.enriched)

tobacco

Search tobacco products by name across brands. Returns enriched product data (variants and flavors) with pagination.

Capability
catalog.search .enriched Pro / Business
Reglas de query
q must be 2–100 characters (trimmed). grams is optional. page defaults to 1; pageSize defaults to 20 (max 50).

Parámetros

Nombre En Tipo Descripción
q query string Search query (product name, 2–100 chars) obligatorio
grams query integer Optional: filter by grams opcional
page query integer Page number (1-based) opcional
pageSize query integer Results per page (max 50) opcional

Respuestas

  • 200 — Default Response
  • 400 — Default Response
  • 401 — Default Response
  • 402 — Default Response
  • 403 — Default Response
  • 429 — Default Response
  • 500 — Default Response

Ejemplo

curl -s -H "X-API-Key: $API_KEY" \
  "https://api.shishapp.es/api/public/v1/tobaccos/search?q=kent&grams=50&page=1&pageSize=20"