Primeros pasos
Base URL
Sección titulada «Base URL»Producción:
https://api.shishapp.es/api/public/v1Todas las rutas de la Public API comercial viven bajo este prefijo. El contrato OpenAPI documenta solo este server de producción.
1. Elige un plan y paga
Sección titulada «1. Elige un plan y paga»Contrata en shishapp.es/pricing. No hay plan gratuito ni sandbox en este modelo de producto.
Starter y Pro son self-serve en la página de pricing. Business se configura con el equipo comercial — contacta support@shishapp.es.
2. Recibe tu API key
Sección titulada «2. Recibe tu API key»Tras confirmar el pago, ShishApp provisiona el acceso y entrega la clave por un canal seguro. La clave nunca se muestra completa en la página de pricing. Rotación, suspensión y revocación las gestiona ShishApp (no hay endpoints públicos de gestión de keys).
Formato típico:
ska_v1_…_…Trátala como secreto. Llama a la API solo desde tu servidor — nunca desde un frontend público ni como query parameter.
Límite de keys activas (por suscripción):
| Plan | Keys activas máx. |
|---|---|
| Starter | 1 |
| Pro | 3 |
| Business | 10 |
Para entrega, rotación o soporte: support@shishapp.es.
3. Primera petición
Sección titulada «3. Primera petición»BASE_URL="https://api.shishapp.es/api/public/v1"API_KEY="ska_v1_…"
curl -i -H "X-API-Key: $API_KEY" "$BASE_URL/brands"Una respuesta correcta incluye cabeceras de rate limit (X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset).
Ejemplo de búsqueda (requiere .enriched — Pro / Business):
curl -H "X-API-Key: $API_KEY" \ "$BASE_URL/tobaccos/search?q=kent&grams=50&page=1&pageSize=20"Contrato OpenAPI
Sección titulada «Contrato OpenAPI»- Referencia de endpoints: Referencia API
- Machine-readable:
/openapi.json
Importa el JSON en Postman, Insomnia o tu herramienta de codegen.
Siguientes pasos
Sección titulada «Siguientes pasos»- Autenticación —
X-API-Keyy códigos de estado - Capabilities y planes —
.basicvs.enriched - Errores y rate limits — 429 y tablas de RPM