Autenticación
Cabecera
Sección titulada «Cabecera»Toda petición a la Public API debe incluir:
X-API-Key: ska_v1_…_…No envíes la clave como query parameter, en el body JSON ni desde código del navegador.
ShishApp emite y gestiona las keys de tu suscripción (entrega, rotación, revocación). No hay Public API de self-service de keys. Para cambios, contacta support@shishapp.es.
Las keys pueden tener fecha de caducidad configurada por ShishApp. Una key caducada, revocada o inválida responde 401 UNAUTHORIZED con un error opaco — la respuesta no revela si la key existía ni el motivo exacto del fallo.
Límite de keys activas: Starter 1, Pro 3, Business 10. Ver Capabilities y planes.
Flujo de autorización
Sección titulada «Flujo de autorización»- Validar la clave (formato, hash, estado, caducidad) → si falla, 401
UNAUTHORIZED(opaco; no revela si la clave existe o fue revocada). - Resolver el acceso de billing de la suscripción → si está bloqueado, 402
BILLING_REQUIRED. - Comprobar la capability del endpoint → si falta, 403
INSUFFICIENT_CAPABILITY. - Aplicar el RPM de la suscripción → si se excede, 429
RATE_LIMIT_EXCEEDED.
| Status | Código | Significado |
|---|---|---|
| 401 | UNAUTHORIZED | API key ausente o inválida |
| 402 | BILLING_REQUIRED | El billing de la suscripción bloquea el acceso |
| 403 | INSUFFICIENT_CAPABILITY | El plan no incluye la capability requerida |
| 429 | RATE_LIMIT_EXCEEDED | Se superó el RPM de la suscripción |
Ver Errores y rate limits para cabeceras, periodo de gracia y forma del payload.
El uso de la API implica la aceptación de los Términos API y la Licencia de datos.