API reference
Commercial Public API endpoints, parameters, and curl examples — generated from the OpenAPI contract.
All endpoints require the X-API-Key header. Production base URL: https://api.shishapp.es
Authentication
Send your commercial API key on every request:
X-API-Key: ska_v1_…_… /api/public/v1/brands List brands (.basic)
Returns all tobacco brands in the catalog.
Parameters
No parameters.
Responses
-
200— Default Response -
401— Default Response -
402— Default Response -
403— Default Response -
429— Default Response -
500— Default Response
Example
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).
Parameters
| Name | In | Type | Description | |
|---|---|---|---|---|
brandId | path | string · uuid | Brand UUID | required |
Responses
-
200— Default Response -
400— Default Response -
401— Default Response -
402— Default Response -
403— Default Response -
404— Default Response -
429— Default Response -
500— Default Response
Example
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.
Parameters
No parameters.
Responses
-
200— Default Response -
401— Default Response -
402— Default Response -
403— Default Response -
429— Default Response -
500— Default Response
Example
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.
Parameters
| Name | In | Type | Description | |
|---|---|---|---|---|
q | query | string | Search query (product name, 2–100 chars) | required |
grams | query | integer | Optional: filter by grams | optional |
page | query | integer | Page number (1-based) | optional |
pageSize | query | integer | Results per page (max 50) | optional |
Responses
-
200— Default Response -
400— Default Response -
401— Default Response -
402— Default Response -
403— Default Response -
429— Default Response -
500— Default Response
Example
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"