Categorías
API Playground

Intro the PlayGround

Estimado consumidor de nuestra API:

El invierno se está asomando por mi ventana, este espacio estaba en blanco y mi jefe justo quiere que mejore mis habilidades comunicacionales. Son muchas señales que decían, “escribe la cuestión” así que no lo ignoraré de momento. Siendo honesto también estoy motivado porque creo que necesitamos este lugar de intercambio y discusión sobre cosas de la API; y ya que hablamos en confianza el invierno tiene poco que ver con el contenido de todo esto, pero jugó un papel fundamental para llevarme al “mood” adecuado y animarme a escribir. Bueno el invierno y el aislamiento social…

Si les parece bien pasamos a temas más importantes, lo principal de este espacio es que está pensado y diseñado para ti, así como nuestra API. Porque la idea es que ambas cosas se complementen te ayuden a sacarle el máximo provecho al consumo de nuestros endpoints sin necesidad de sobrecargar nuestros servicios ni afectar la operatividad de tu empresa, ni ninguna otra.

¿Cómo sabemos que la API se ajusta a tus necesidades? Partamos por el principio. Tenemos varios años de experiencia en el área de gestión de asistencia y trasladamos todo ese conocimiento a nuestra plataforma, para hacerte el día a día lo más fácil posible. El tener una línea de productos así hace que la API también lo sea, porque la tendencia de nuestra API es justamente esa, brindarte la posibilidad de consumir por protocolo REST todas las funcionalidades que puedes hacer en nuestra plataforma de gestión.

Nuestra plataforma consta de varias versiones, porque como somos dinámicos e incrementales siempre queremos mejorar tu experiencia de usuario y (nuevamente) facilitarte tu trabajo diario. Básicamente todo lo que encierra nuestra filosofía #yoteayudo. Y ese dinamismo también aplica a la API, por lo que (evidentemente) no es estática y está en constante evolución, añadiremos mejoras sistemáticas a los métodos ya soportados y al mismo tiempo funcionalidades nuevas, por lo que te aconsejamos que tengas en cuenta esto a la hora de realizar el diseño para el consumo de nuestros endpoints. Esto no implica que haremos cambios a lo que ya está publicado, sino que se agregarán campos, métodos, entornos de pruebas, etc. Cualquier cosa que nuestro equipo determine que te serán útil y/o mejorarán tu experiencia de consumo.

Actualmente tenemos 2 versiones funcionales de nuestra plataforma: GV2 y GV3; y para cada una de ellas tenemos un conjunto de endpoints que te permitirá realizar todos los procesos de ambas a través de nuestra API. Por lo que cada vez que estemos hablando sobre un método en especifico siempre te aclararemos a que conjunto de endpoints pertenece. Vale aclarar que sino sabes cual versión de la plataforma utiliza tu empresa, puedes siempre consultarle a nuestro equipo de soporte, que ellos están capacitados para determinarlo y, además, tienen muchas mejores habilidades comunicacionales que nosotros los desarrolladores.

Ten en cuenta que existe un tercer conjunto: el DORADO, el cual es personalizable en términos de endpoints y de restricciones para el consumo de los mismos, pero el entrar en esta categoría tiene un costo asociado, el cual debe ser determinado con el ejecutivo de ventas y jefe de proyectos que atiende tu empresa.

En este blog, subiremos artículos que contaran casos de uso de la API, con la idea de compartirte experiencias anteriores que puedan facilitarte el uso y consumo de los distintos endpoints, así como que conozcas la mejor forma de sacarle provecho a los mismos. Una especie de buenas prácticas con hazlo tú mismo, siempre con al anhelo de aburrirte mucho en el proceso y recibir tu feedback en el cajón de comentarios. Bueno, creo que es suficiente para un post introductorio, espero estar cumpliendo las expectativas de mi jefe; y sino al menos intentaré que todo esto te sea útil, porque si de algo puedes estar seguro, es que esta columna es para ti.