Lanzamiento de la versión 2.0 de la API On-Demand + guía práctica del usuario

¿Qué hay de nuevo?

La versión 2.0 recientemente lanzada trae muchos cambios y características que nuestros clientes han estado pidiendo:

Obteniendo tu token gratis

Obtienes un token gratis con tu cuenta comercial que te dará suficiente crédito para jugar. Puede encontrar el suyo navegando a su Panel de API .

Una vez que lo tenga, abra la documentación de la API en una nueva pestaña para que pueda seguir leyendo la guía práctica aquí

Guía paso por paso

Los pasos a continuación mostrarán lo fácil que es interactuar con la API.

En la página de documentación, podrá desplazarse por las especificaciones.

1. Autenticar

Cada llamada debe estar autenticada, por lo que debe poner el token que desea usar en contexto. Simplemente inserte el token en el formulario designado y presione el botón "Guardar". A partir de aquí, todas las llamadas de servicio se asociarán a su cuenta.

2. Ver todos los servicios disponibles

En el menú de la izquierda puede encontrar una lista de los servicios disponibles. Al hacer clic en cada uno, accederá a los detalles del punto final, donde puede encontrar información como los parámetros requeridos y el formato detallado de la respuesta.

3. Ingrese al modo de prueba

Haga clic en el botón "Probar" que activará el modo de prueba y podrá enviar solicitudes en vivo.

Una vez que esté en modo de prueba, tendrá la especificación de la solicitud en la columna central y un cuadro de texto con la carga útil de su solicitud a la derecha. Estará precargado con valores de prueba que deberá personalizar.

4. Caso de prueba de muestra

Uno de los escenarios más simples es intentar averiguar cuál es la posición actual de una aeronave específica.

Hemos editado la carga útil de muestra eliminando todo excepto nuestro criterio: obtener la posición actual de la aeronave con el número de cola G-TTNG. Después de presionar el botón "Enviar solicitud", deberíamos obtener una respuesta en segundos. Si todo va bien, deberíamos ver el código de estado de la solicitud y la carga útil de respuesta apareciendo debajo de la solicitud inicial.

La documentación de los campos de respuesta debe estar visible a la izquierda de la carga útil de la respuesta, lo que facilita la interpretación de los datos.

Implementando su propio cliente

La interfaz que se muestra arriba es excelente para crear prototipos de sus llamadas, pero, por supuesto, aún necesita implementar su propio cliente API. Mostraremos lo fácil que es tener un SDK de API de Python completo que funcione con solo unas pocas líneas de código.

Puede descargar el cliente de servicio web en su lenguaje / marco favorito; actualmente admitimos los más populares, como C #, Java, PHP, Python, Scala, Swift y Javascript.

Simplemente seleccione su opción de uno de los elementos en el menú desplegable y la descarga comenzará automáticamente. Una vez completado, debe extraer el archivo y abrir el contenido en su IDE favorito.

El archivo README.md contiene información valiosa y está adaptado al marco que nos interesa. En este caso, hay instrucciones sobre cómo configurar su entorno Python para poder ejecutar el cliente API sin problemas. También hay fragmentos de código que puede copiar / pegar directamente en su código.

Hemos copiado los fragmentos del archivo README en nuestro propio archivo "liveflights-client.py" y solo necesitamos agregar dos cosas: la cadena de autenticación (token de portador) y el parámetro de búsqueda (registro "G-TTNG"), lo mismo como la llamada que hemos creado previamente en la interfaz de prueba.

Después de guardar el archivo podemos abrir una terminal y usar Python para ejecutar el cliente que acabamos de implementar.

Esperamos que esta guía de inicio rápido haya sido útil.

Consulte también nuestra compilación de ejemplos prácticos y casos de uso comunes visitando https://www.radarbox.com/blog/on-demand-api-v2-examples