Errores y límites
Formato de errores, códigos HTTP y límites de la API.
Formato de error
Todos los errores responden con el código HTTP correspondiente y un body:
{ "error": "Descripción del problema" }Los errores de validación incluyen el detalle del campo:
{ "error": "body/to must NOT have fewer than 8 characters" }Códigos
| Código | Significado |
|---|---|
400 |
Request inválido (validación) o token de vinculación inválido |
401 |
API Key faltante o inválida |
403 |
Acceso denegado: IP/dominio no permitido, suscripción vencida, límite del plan alcanzado o sesión no conectada |
404 |
Recurso no encontrado |
409 |
Conflicto (p. ej. recurso en uso) |
429 |
Demasiadas solicitudes (rate limit) |
500 |
Error interno |
Límites
| Límite | Valor |
|---|---|
| Rate limit global | 100 requests/minuto por IP |
| Endpoints de autenticación | Límites reforzados (10/min login) |
| Tamaño máximo de archivo | 50 MB |
| Sesiones (líneas) | Según tu plan |
| Mensajes | Ilimitados en planes de pago (sujeto a uso razonable) — el envío se espacia con delays automáticos |
Delays anti-bloqueo
Cada línea envía con una pausa aleatoria entre mensajes (definida por tu plan). Esto protege tu número: WhatsApp penaliza los envíos a ráfaga. En envíos masivos, la cola espacia todo automáticamente — tu sistema solo encola y olvida.