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
Autenticación
Envía tu API key comercial en cada petición:
X-API-Key: ska_v1_…_… /api/public/v1/brands List brands (.basic)
Returns all tobacco brands in the catalog.
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" /api/public/v1/brands/{brandId}/tobaccos List tobaccos by brand (.basic)
Returns tobacco products for a brand (basic product fields).
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" /api/public/v1/flavors List flavor tags (.enriched)
Returns all flavor tags.
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" /api/public/v1/tobaccos/search Search tobaccos (.enriched)
Search tobacco products by name across brands. Returns enriched product data (variants and flavors) with pagination.
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"