Saltearse al contenido

Autenticación

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.

  1. Validar la clave (formato, hash, estado, caducidad) → si falla, 401 UNAUTHORIZED (opaco; no revela si la clave existe o fue revocada).
  2. Resolver el acceso de billing de la suscripción → si está bloqueado, 402 BILLING_REQUIRED.
  3. Comprobar la capability del endpoint → si falta, 403 INSUFFICIENT_CAPABILITY.
  4. Aplicar el RPM de la suscripción → si se excede, 429 RATE_LIMIT_EXCEEDED.
StatusCódigoSignificado
401UNAUTHORIZEDAPI key ausente o inválida
402BILLING_REQUIREDEl billing de la suscripción bloquea el acceso
403INSUFFICIENT_CAPABILITYEl plan no incluye la capability requerida
429RATE_LIMIT_EXCEEDEDSe 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.