Herramienta utilizada para la demo. Postman
Colección preparada para la demo adjunta: Server Files.postman_collection.json.
¿Porque utilizamos POSTMAN? Porque es gratuita y ofrece ayuda para programar en cualquier lenguaje y replicar todas las llamadas que hacemos desde la propia herramienta.
En la pestaña de la llamada, podemos ver a la derecha de la pantalla (de la herramienta POSTMAN) el siguiente icono.
Al hacer click, nos mostrará algo similar a lo que se ve en la captura a continuación. Ahí podemos seleccionar cualquier lenguaje de programación para ver ejemplos de como replicar la llamada que acabamos de testear
Importar colección
En el botón a la derecha de la captura de Import es donde podremos añadir, usando el fichero adjunto en el tutorial; la colección para hacer las pruebas.
Una vez importado, veremos algo similar a esto. La carpeta Server Files es la que nos ha tenido que aparecer al importar, pero si ya tienes más de una colección se unirá y aparecerá por orden alfabético.
Para poder configurar nuestra colección debemos introducir nuestro nombre de cliente. Y para eso debemos hacer doble click en la carpeta Server Files para que se abra una pestaña de configuración.
Donde, al seleccionar en la pestaña Variables, nos mostrará la siguiente imagen y podemos introducir el nombre de cliente que corresponde a la Api (es el mismo que se utiliza para el subdominio del Mobility Server
Ahora, hacemos doble click en Api Login, ya que para poder realizar cualquier petición a nuestra API requerimos de un token de autenticación.
Y nos aparecerá una pantalla como esta
En las pestañas situadas debajo de la URL, selecionamos Authorization. Y en el selector de Type buscamos Basic Auth, para poder introducir el Usuario y contraseña que nos habrán facilitado desde soporte/implantación.
Una vez introducidos, ya podremos realizar la llamada.
NOTA: En la colección el paso que voy a detallar está automatizado ya que el token se guarda en una variable para poder utilizarlo en la siguiente llamada.
La llamada a Login, nos devolverá un token, que debemos guardarlo para la siguiente llamada.
Ahora, tenemos que hacer doble click en Upload Imagenes. E igual que con login accederemos a la pestaña de Authorization, pero esta vez seleccionaremos el Type - Bearer Token.
RECORDATORIO: En la colección este paso está automatizado. El {{token}} corresponde a una variable de postman que será sustituida por el resultado de la llamada anterior.
En un procedimiento manual, tendríamos que sustituir la palabra {{token}}, por el token que hemos copiado de la llamada a /login, en el paso anterior.
Una vez pegado el token, recuerda que tiene una caducidad de 20 minutos. Pasado ese tiempo, tendrás que solicitar uno nuevo repitiendo el paso anterior.
Ahora es cuando podemos añadir las imágenes que queremos subir.
Por lo que tenemos que acceder a la pestaña Body y seleccionar la opción form-data. Que nos aparecerá con un listado vacio.
Añadimos la KEY "images" y al mover el cursor por encima de la palabra "images" al final del cajón nos aparecerá un seleccionable que nos dejará cambiar de TEXT a FILE.
En ese momento la columna VALUE, nos permitirá incluir ficheros que tenemos en nuestro pc.
Incluimos las imágenes que necesitamos y ya podremos enviar la petición.
Si la llamada ha ido bien, nos mostrará un mensaje donde "data" tendrá una respuesta por fichero subido y un nuevo token, con la caducidad actualizada, que podremos utilizar en una próxima llamada.