Skip to main content
El SDK lanza instancias de NippyError para errores operacionales. Usa NippyErrorCodes para manejar cada caso de forma explícita.
No muestres mensajes internos de error directamente al usuario. Registra error.code, error.status y error.traceId para diagnóstico.

Patrón base

Códigos de error

Causa: El usuario giró recientemente y el cooldown de la campaña sigue activo.Solución: Consulta getState() y muestra nextEligibleAt.
Causa: El usuario agotó sus spins permitidos en la campaña.Solución: Deshabilita el botón de girar y muestra el estado actual.
Causa: El campaignId no existe, no pertenece al negocio o la campaña está inactiva.Solución: Verifica el ID de campaña y su estado antes de exponerla en tu app.
Causa: Se llamó claim() para un premio que ya fue reclamado.Solución: Trata el caso como idempotente y muestra el premio ya reclamado.
Causa: El usuario no reclamó el premio antes de la expiración de la reserva.Solución: Informa que el tiempo expiró y vuelve a consultar getState().
Causa: Falta la API key o la key es inválida.Solución: Revisa NIPPY_API_KEY y confirma que use el prefijo correcto.
Causa: La API key no tiene acceso al recurso solicitado.Solución: Revisa permisos y pertenencia del recurso en la consola.
Causa: Faltan campos requeridos o algún valor tiene formato incorrecto.Solución: Valida los datos antes de llamar al SDK.
Causa: Nippy respondió con un error 5xx después de los reintentos automáticos.Solución: Registra traceId, muestra un estado genérico y reintenta más tarde.

Propiedades de NippyError