API Reference

Inspiración y uso de esta API

¡Hola! Soy Víctor, un desarrollador igual que tú. Liberé esta API con el propósito de añadir servicios necesarios o útiles para otros desarrolladores como nosotros.
En mis diversos proyectos, debo conectarme a varias fuentes de datos para obtener información, el problema surge cuando alguna fuente cambia, ya que tengo que modificar cada proyecto individualmente. Con esta API, pretendo contar con un "proxy" o punto único de acceso único a la información. Si la fuente cambia o desaparece, simplemente me dirijo a otra fuente, lo que significa que solo debo realizar el cambio en esta API y no en cada proyecto de forma individual.

📘

Para evitar el abuso la API se ha limitado un máximo 5 request cada 10 segundos, sobre eso recibirás un error 429 Too Many Request y estarás bloqueado por 1 minuto.

Cualquier abuso detectado se bloqueará a la brevedad. Si quieres que te desbloqueemos o necesitas aumentar el rate limit escríbeme a [email protected].

No se recomienda usar un marcador de tiempo en la petición, ej: https://api.boostr.cl/holidays.json?t=1234567890 ya que internamente el servidor ignora los parámetros para guardar el cache, éste funciona con 5 minutos de TTL independiente lo que ingresen en la URL.

Cabe destacar que esta API siempre va a buscar la información a las fuentes originales, en cada servicio se informa cuál es la fuente, por lo que cualquier dato erróneo no me puedo hacer responsable pero si detectan que un servicio tiene errores o la información no es prolija, les pido me avisen y con gusto confirmaré la fuente sino buscaré otra con el fin de mantener online el servicio lo más rápido que pueda.
Esta API actúa como un proxy que permite leer de una manera fácil la información que está disponible en distintos portales de forma gratuita aplicando técnicas como webscraping o leyendo información de API públicas que en algunos casos requieren registro.

Información general

URL

Recomiendo utilizar Insomia o Postman para que pruebes todos los servicios disponibles.
La URL base de la API es:

https://api.boostr.cl/

Formato respuesta

Todos los endpoints entregan la información en formato JSON y el formato en caso de éxito será

{
	"status": "success",
	"data": {
	}
}

En caso de error:

{
	"status": "error",
	"data": null,
	"code": "Código del error",
	"data": "Mensaje de error"
}

En caso que seas bloqueado por exceso de request a la API (recuerda que un máximo de 5 reqs/10 segundos):

429 Too Many Request

También puede ser, en ciertos casos de abuso reiterado o constante, que el sistema te bloquee permanentemente, ya ha ocurrido un par de veces. El bloqueo es definitivo y sin derecho a reclamo, el servicio es gratis y estas medidas colaboran para esto siga así. Aún así si crees que se te bloqueó injustamente y quieres que te desbloquee, escríbeme a [email protected], cuéntame qué servicios usas y desde cuál IP los estás consumiendo.

Aportes, feedback, pedidos.

¿Tienes en mente un nuevo servicio? ¿o encontraste un error? ¿o podemos mejorar un servicio existente? Ingresa a https://github.com/boostrapps/api/discussions y conversemos, toda sugerencia es más que bienvenida.

Gratis

Sí, la idea de esta API es mantenerla sencilla, actualizada, útil y gratis.

Por ahora el costo del servicio es bajo y con medidas como rate limit y cache he logrado que la alta carga del servicio no aumente la facturación, aunque eso no quiere decir que no acepte donaciones o que a futuro publique servicios que sean de pago o que un mismo servicio tenga una versión gratuita y otra mas completa de pago (como el caso de las Patentes), lo que se denomina freemiun.

Si necesitas aumentar el rate limit o requieres algún servicio que no esté listado, contáctame y veamos cómo te puedo ayudar.