Límites de tarifas, restricciones y errores de API

Limitación de velocidad

De forma predeterminada, las cuentas estándar están limitadas a una cierta cantidad de solicitudes por segundo (que se muestran en Configuración > API > Límites). Más allá de eso, la API devuelve un error "429 Demasiadas solicitudes". Las cuentas de alto volumen podrán solicitar un aumento en este límite.

Códigos de respuesta HTTP comunes

• 200 OK — solicitud procesada exitosamente
• 400 Bad Request: parámetro faltante o con formato incorrecto (por ejemplo, número no válido)
• 401 No autorizado: falta la clave API o no es válida
• 402 Pago requerido: saldo insuficiente
• 429 Demasiadas solicitudes: se superó el límite de tasa
• 500 Error interno del servidor: error en la plataforma, comuníquese con el soporte técnico con el ID de solicitud

Mejores prácticas

• Implementar lógica de reintento con retroceso exponencial en los errores 429 y 500
• Registre sistemáticamente el message_id devuelto para facilitar cualquier diagnóstico futuro
• Utilice el modo sandbox para probar su integración sin consumir créditos reales ni enviar mensajes reales