Capabilities y planes
La autorización comprueba capabilities, no nombres de plan en las URLs. .basic y .enriched son niveles de capability, no versiones de API.
Mapa de capabilities
Sección titulada «Mapa de capabilities»| Superficie | Nivel | Capability |
|---|---|---|
GET /brands | .basic | catalog.brands.read |
GET /brands/:brandId/tobaccos | .basic | catalog.tobaccos.basic.read |
GET /flavors | .enriched | catalog.flavors.read |
GET /tobaccos/search | .enriched | catalog.search |
La búsqueda devuelve datos de producto enriched (variantes y sabores). Esa forma enriquecida forma parte del tier .enriched junto a los endpoints de arriba.
| Plan | Capabilities | Keys activas máx. | Notas |
|---|---|---|---|
| Starter | .basic | 1 | Marcas y tabacos; checkout self-serve |
| Pro | .enriched (incluye todo .basic) | 3 | Sabores + búsqueda; checkout self-serve |
| Business | .enriched | 10 | Mayor RPM; configuración comercial (contactar soporte); RPM custom posible |
Qué expone cada nivel
Sección titulada «Qué expone cada nivel»Estructura de catálogo normalizada: marcas, productos de tabaco, variantes, formatos, gramos, nombres / display names.
.enriched
Sección titulada «.enriched»Todo lo de .basic, más sabores y búsqueda de tabacos (q, grams opcional, paginación).
Periodo de gracia de billing
Sección titulada «Periodo de gracia de billing»Si la suscripción pasa a past due, el acceso a la API continúa 7 días naturales. Pasado ese periodo, las peticiones reciben 402 BILLING_REQUIRED hasta restaurar el billing. Ver Errores y rate limits.
Pricing
Sección titulada «Pricing»Detalle comercial y checkout: shishapp.es/pricing. Business y soporte de keys: support@shishapp.es.