Límites

Guía de Límites de la API de Hablame

En Hablame, nos esforzamos por ofrecer una API robusta y confiable que permita a los desarrolladores integrar nuestras soluciones de telecomunicaciones de manera eficiente y segura. Para garantizar un servicio óptimo y justo para todos nuestros usuarios, hemos establecido ciertos límites en el uso de nuestra API. Estos límites están diseñados para prevenir el abuso del sistema y asegurar que nuestra infraestructura pueda servir de manera efectiva a una amplia gama de consumidores.

Límites de Solicitudes

Para mantener la estabilidad y la disponibilidad de nuestra API, imponemos un límite en el número de solicitudes que se pueden realizar en un determinado período de tiempo. Este límite se conoce comúnmente como "Rate Limiting".

• Límite por Minuto: Cada endpoint de API puede realizar hasta X solicitudes por hora, minuto o segundo. este limite se indicará en la docomentación de cada método y se indicará en los Headers de cada respuesta API, así:

GET /endpoint HTTP/1.1
x-ratelimit-limit: 100 #Limite de solicitudes
x-ratelimit-remaining: 45 #Solicitudes restantes permitidas para el periodo de tiempo actual
x-ratelimit-reset: 58 #Segundos restantes para el inicio del nuevo periodo

• Superar estos límites resultará en una respuesta de error con el código de estado HTTP 429 (Too Many Requests), indicando que se ha excedido el límite de solicitudes permitidas. utilice la cabecera 'x-ratelimit-reset' para saber en cuantos segundos puede reintentar su solicitud.
• Límite por minuto: Además, existe un límite de solicitudes por minuto/IP de origen de 35.000 de solicitudes, al superar este límite, nuestro firewall bloqueará la IP por 6 horas. esta valor se indicará en el Header x-ratelimit-ip, así:

GET /endpoint HTTP/1.1
x-ratelimit-ip: 100 #Número de llamadas API desde la IP en este minuto

Políticas de Uso

Además de los límites técnicos, es importante adherirse a nuestras políticas de uso responsable. Estas políticas están diseñadas para garantizar que nuestra API se utilice de manera que promueva la seguridad, la privacidad y el respeto por todos los usuarios.

• Uso Justo: Esperamos que todos los consumidores de la API hagan un uso justo de los recursos, evitando prácticas que puedan degradar la experiencia de otros usuarios, como el envío de solicitudes en ráfagas innecesarias o el abuso de endpoints específicos.
• Datos Sensibles: Al manejar datos sensibles o personales, es esencial seguir las mejores prácticas de seguridad y cumplir con las regulaciones aplicables, como el GDPR en Europa.

Mejores Prácticas

Para ayudarte a adherirte a estos límites y políticas, recomendamos seguir unas mejores prácticas:

• Manejo de Errores: Implementa una lógica adecuada en tu aplicación para manejar las respuestas de error 429, posiblemente mediante reintentos con una estrategia de backoff exponencial.
• Optimización de Solicitudes: Asegúrate de que tus solicitudes a la API estén optimizadas para obtener la información necesaria en el menor número de llamadas posible.
• Monitoreo: Utiliza las cabeceras de respuesta relacionadas con el límite de solicitudes para monitorear tu uso actual y ajustar dinámicamente tus solicitudes.

Contacto y Soporte

Si encuentras dificultades con los límites de la API o necesitas un límite de tasa personalizado para tu aplicación, por favor, no dudes en contactarnos. Nuestro equipo está aquí para ayudarte a encontrar la mejor solución para tus necesidades específicas.