Getting started
Base URL
Section titled “Base URL”Production:
https://api.shishapp.es/api/public/v1All commercial Public API routes live under this prefix. The OpenAPI contract documents this production server only.
1. Choose a plan and pay
Section titled “1. Choose a plan and pay”Subscribe from shishapp.es/pricing. There is no free plan or sandbox in this product model.
Starter and Pro are self-serve on the pricing page. Business is sales-configured — contact support@shishapp.es.
2. Receive your API key
Section titled “2. Receive your API key”After payment is confirmed, ShishApp provisions access and delivers your key through a secure channel. The key is never shown in full on the pricing page. Rotation, suspension, and revocation are handled by ShishApp (there is no Public API for key management).
Keys look like:
ska_v1_…_…Treat the key as a secret. Call the API only from your server — never from a public frontend, never as a query parameter.
Active key limits (per subscription):
| Plan | Max active keys |
|---|---|
| Starter | 1 |
| Pro | 3 |
| Business | 10 |
For key delivery, rotation, or support: support@shishapp.es.
3. First request
Section titled “3. First request”BASE_URL="https://api.shishapp.es/api/public/v1"API_KEY="ska_v1_…"
curl -i -H "X-API-Key: $API_KEY" "$BASE_URL/brands"A successful response includes rate-limit headers (X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset).
Search example (requires .enriched — Pro / Business):
curl -H "X-API-Key: $API_KEY" \ "$BASE_URL/tobaccos/search?q=kent&grams=50&page=1&pageSize=20"OpenAPI contract
Section titled “OpenAPI contract”- Endpoint reference: API reference
- Machine-readable:
/openapi.json
Import the JSON into Postman, Insomnia, or your codegen tooling.
Next steps
Section titled “Next steps”- Authentication —
X-API-Keyand status codes - Capabilities and plans —
.basicvs.enriched - Errors and rate limits — 429 and RPM tables