Errores y límites
Qué responde una llamada rechazada, y los límites que aplica la API.
Errores
Una llamada rechazada responde con un cuerpo JSON { statusCode, error, message }. El mensaje dice qué está mal.
| Estado | Mensaje | Significado |
|---|---|---|
| 400 | varía | Falta un campo obligatorio, no se indicó un destino o un valor del estado no está permitido (layout, countdownStyle, progressStyle, versus.activeSide, countdownTo, segments). El mensaje indica el campo. |
| 401 | API_KEY_REQUIRED / INVALID_API_KEY | El encabezado x-api-key falta o es incorrecto. |
| 402 | PLAN_SELECTION_REQUIRED | El equipo no ha elegido un plan. Elige uno en el panel (el plan gratis sirve). |
| 402 | FREE_TIER_LIMIT_REACHED | Se agotaron los envíos push mensuales del plan gratis. Consulta entrega y facturación. |
| 403 | ACCOUNT_SUSPENDED | La cuenta dueña de este equipo está suspendida. Consulta los Términos del servicio. |
| 404 | No activity matched | No se encontró en este contenedor ninguno de los ids de actividad enviados. |
| 413 | The "state" object is too large | El estado supera los 16KB. |
| 413 | The notification is too long | Una notificación push supera los 4KB. |
| 429 | varía | Demasiadas solicitudes en poco tiempo. Espera y vuelve a intentarlo. |
| 500 | Internal Server Error | Algo falló de nuestro lado. Inténtalo más tarde. |
Límites
| Qué | Límite |
|---|---|
state | 16KB de JSON. |
segments | 12 pasos. Las etiquetas se cortan a los 60 caracteres. |
countdownTo | Segundos de época Unix, como número. |
| Texto en la tarjeta | Consulta texto que cabe. |
| Imágenes | URL https completas que el celular pueda descargar. WebP es lo mejor; PNG y JPEG también funcionan; SVG no. Consulta imágenes que encajan. |
| Notificación push | 4KB. |
| Solicitudes | Sin límite de tasa fijo. El tráfico muy alto puede bloquearse con un 429. Si una actividad recibe varias actualizaciones en 45 segundos, solo se envía la más reciente. |
| Celulares por grupo o botón con reutilización | Sin límite. |
| Respuesta del webhook | 8 segundos. |
