0% encontró este documento útil (0 votos)
64 vistas13 páginas

2.4.2 Explore Las API REST Con El Simulador API y Postman

Este documento describe cómo usar el simulador de API y Postman para realizar llamadas a una API de biblioteca. Se explica cómo explorar la documentación de la API usando el simulador y cómo realizar llamadas usando CURL y cambiando parámetros como includeISBN.
Derechos de autor
© © All Rights Reserved
Nos tomamos en serio los derechos de los contenidos. Si sospechas que se trata de tu contenido, reclámalo aquí.
Formatos disponibles
Descarga como DOCX, PDF, TXT o lee en línea desde Scribd
0% encontró este documento útil (0 votos)
64 vistas13 páginas

2.4.2 Explore Las API REST Con El Simulador API y Postman

Este documento describe cómo usar el simulador de API y Postman para realizar llamadas a una API de biblioteca. Se explica cómo explorar la documentación de la API usando el simulador y cómo realizar llamadas usando CURL y cambiando parámetros como includeISBN.
Derechos de autor
© © All Rights Reserved
Nos tomamos en serio los derechos de los contenidos. Si sospechas que se trata de tu contenido, reclámalo aquí.
Formatos disponibles
Descarga como DOCX, PDF, TXT o lee en línea desde Scribd
Está en la página 1/ 13

Implementación EPA

Subdirección de Diseño instruccional

Telepresencia y
Nombre de la entornos innovadores
Sigla Asignatura CUY6142 Tiempo 2 horas
Asignatura de colaboración
humana
Experiencia de Aprendizaje N° 2 Herramientas disponibles para la colaboración
Actividad N° 2.4 Entendiendo y usando APIs

Nombre del Recurso Didáctico 2.4.2 Explore las API REST con el Simulador API y Postman

Objetivo de la Actividad

En esta actividad, usted aprenderá a usar el simulador de API de la biblioteca escolar para realizar llamadas a la API para
enumerar, agregar y eliminar libros. Más tarde, usarás Postman para realizar estas mismas llamadas a la API. Después de
completar esta actividad, usted será capaz de cumplir con estos objetivos:

 Explorar la documentación de API usando el simulador de API

 Usar el Postman para realizar llamadas API al simulador de API

Recursos Requeridos
Estos son los recursos y equipos que se requieren para completar esta actividad:

 Un computador con VirtualBox o VMWare

 Máquina virtual (Virtual Machine) DEVASC.

https://static-course-assets.s3.amazonaws.com/DEVNET/DEVASC_VM.ova

Parte 1: Iniciar la Máquina virtual de DEVASC


Si usted no ha completado el laboratorio - Instale el Entorno de Laboratorio de la Máquina Virtual, hágalo ahora. Si usted lo ha
completado ya, inicie la máquina virtual DEVASC.

Parte 2: Explore la documentación API usando el simulador de API


Para entender cómo realizar llamadas a una API REST, los desarrolladores suelen empezar estudiando la documentación de la API. El
formato para las solicitudes, respuestas, encabezados y parámetros para las API REST se documentan normalmente mediante la
especificación OpenAPI (anteriormente la especificación Swagger).

Paso 1: Abrir el Web Browser Chromium.


Haga doble clic al ícono de Web Browser Chromium en el escritorio

Paso 2: Conéctese al sitio Web de la Biblioteca de la Escuela.


Si el navegador no ha abierto automáticamente el sitio web de la Biblioteca de la Escuela, en la barra de direcciones escriba:
library.demo.local y presione volver para ir allí.
Paso 3: Vaya a la página de documentos de API.
a. El sitio web se establece de forma predeterminada en la pestaña Nuestros libros y muestra una lista de libros. En la esquina
superior derecha donde indica, Haga clic aquí para ver documentos de API, haga clic en aquí para ir a la página web de
documentación de API.
Ahora usted verá una lista de APIs en el espacio de nombre predeterminado /api/v.1.
b. Observe la flecha hacia abajo a la derecha. Al hacer clic en cualquier parte de la barra /api/v1 se minimiza la lista de API y se
girará la flecha hacia la derecha. Haga clic de nuevo en la misma barra para volver a mostrar la lista de API.
Observe el bloqueo a la derecha de varias de las API. El bloqueo indica que estas API puede requerir un token para ser utilizado.

Paso 4: Enumera libros con la API GET /books.


Haga clic en cualquier parte de la barra de la API GET /books Esta API vuelve a una lista de libros de la biblioteca escolar.
 Parámetros - Hay varios parámetros de API opcionales. Estos se pueden usar para filtrar, ordenar o paginar la salida.
Estos serán referidos más adelante en este laboratorio.
 Tipo de contenido de respuesta - clic en aplicación/JSON para ver una lista de los diferentes tipos de formatos de
datos que se puede visualizar en la información. Deje la selección como aplicación/JSON.
 Código - El código muestra 200 de forma predeterminada, lo que indica que la solicitud de API del servidor fue un
éxito como se muestra en la descripción. (Usted todavía no ha enviado una solicitud de API).

Paso 5: Utilice la función Try out en la documentación de la API.


Una de las características más potentes de la especificación API Abierta (OpenAPI) es la capacidad de probar una llamada API para
ver si la construyó correctamente. Usted también puede revisar la respuesta para ver si es lo que esperaba. Usted verá esta misma
característica de prueba en la documentación de API para Cisco, MapQuest y otras organizaciones que utilizan esta característica de
especificación OpenAPI.
a. En la documentación de la API GET /books haga clic en el botón Probar
b. Observe que ahora tiene la opción de introducir información para los parámetros opcionales. Deje los parámetros en blanco y
haga clic en el botón Ejecutar
En la sección Respuestas usted verá:
 CURL: El comando CURL que puede utilizar para tener acceso a la misma información para la API /books.
 URL de solicitud: esta URL es usada en la solicitud de API, que se puede utilizar para solicitar la misma información
usando CURL, Postman y Python.
 Código: Este es el código de respuesta HTTP. 200 indica una llamada exitosa.
 Cuerpo de respuesta: Lista de libros en formato JSON.
 Encabezados de respuesta: información sobre la API devuelta desde el servidor.
En el cuerpo de la respuesta usted verá una lista de libros en formato JSON:
[
{
«ID":0,
"Título": "Fundamentos del enrutamiento IP",
"author": «Mark A. Sportack»
},
{
"ID":1
«Título» «Python para tontos»
«author» «Stef Maruch Aahz Maruch»
},
{
"id"2
«Título» «Linux para Trabajadores de NET»
«author» «Cisco Systems Inc»
},
{
«id» 3,
«Título» «NetACad: 20 años de aprendizaje en línea»
«author» «Cisco Systems Inc»
}
]

Paso 6: Utilice el comando CURL en una ventana terminal.


La API GET /books proporciona información para acceder al contenido mostrado en el cuerpo de [
{
«ID":0,
"Título": "Fundamentos del enrutamiento IP",
"author": «Mark A. Sportack»
},
{
"ID":1
«Título» «Python para tontos»
«author» «Stef Maruch Aahz Maruch»
},
{
"id"2
«Título» «Linux para Trabajadores de NET»
«author» «Cisco Systems Inc»
},
{
«id» 3,
«Título» «NetACad: 20 años de aprendizaje en línea»
«author» «Cisco Systems Inc»
}
]
respuesta mediante CURL. CURL es una herramienta de línea de comandos para transferir datos hacia o desde un servidor,
utilizando cualquiera de los protocolos admitidos, incluidos HTTP y HTTPS.
a. Seleccione el comando CURL, haga clic con el botón derecho y cópielo en su portapapeles:
Curl -X GET "http://library.demo.local/api/v.1/books" -H «accept: application/JSON»
Abran una ventana del terminal. Haga clic con el botón derecho y Pegue los contenidos del portapapeles en el terminal y pulse
Intro. Observe que esto proporciona la misma información que la interfaz OpenAPI de la biblioteca.
devasc @labvm: ~$ CURL -X GET "http://library.demo.local/api/v1/books" -H «aceppt: application/JSON»
[
{
«ID» 0,
"Título": "Fundamentos del enrutamiento IP",
«author",: «Mark A. Sportack»
},
{
"id":1
«Título» «Python para tontos»
«author» «Stef Maruch Aahz Maruch»
},
{
"id"2
«título» «Linux para Trabajadores de NET»
«author» «Cisco Systems Inc»
},
{
«id» 3,
«título» «NetAcad: 20 años de aprendizaje en línea»
«author» «Cisco Systems Inc»
}
]
devasc@labvm:~$

Paso 7: Enumera libros con su ISBN utilizando la API GET /books.


a. Vuelva a la API GET /books del sitio web de la biblioteca escolar.
b. En la sección Parámetros, seleccione la flecha abajo junto al parámetro include ISBN parámetro y seleccione verdad (true)
c. Haga clic en Ejecutar.
Observe los siguientes cambios en Respuestas:
 CURL ahora incluye el parámetro para ISBN.
curl -X GET "http://library.demo.local/api/v1/books?includeISBN=true"-H «accept: application/json»
 La URL de solicitud ahora incluye el parámetro para ISBN.
http://library.demo.local/api/v1/books?IncludeIsBN=True
 El cuerpo de la respuesta tiene la misma lista de libros que se muestra anteriormente, pero ahora incluye el ISBN del
libro.
Para minimizar el desplazamiento, cuando haya terminado con una API, puede cerrar esa ventana específica de API haciendo
clic en cualquier parte de la barra de título. Ahora puedes ver todas las API más fácilmente.

Paso 8: Obtener un token usando la API POST /LoginViaBasic.


a. Haga clic en la API POST /LoginViaBasic.
b. Observe que no hay parámetros. Haga clic en Probar y, a continuación, haga clic en Ejecutar.
c. Un cuadro de Iniciar sesión le pedirá a usted un nombre de usuario y contraseña Ingrese la siguiente información y haga clic en
Iniciar sesión
 Nombre de Usuario: cisco
 Contraseña: Cisco123!
d. El token se mostrará en el cuerpo de la respuesta. Seleccione la información entre las comillas, haga clic con el botón derecho y
Copie la información en su portapapeles. Su token será diferente de la que se muestra a continuación.
{
''token»: "cisco|Kzzzteqbc5iv3hkezb7hcj6qhqxen4rlgh72yjkevfs"
}
e. Desplázate hacia arriba hasta la parte superior de la página API de la biblioteca escolar y haz clic en el botón verde Autorizar.
Aparecerá el cuadro de diálogo Autorizaciones disponibles.
f. Haga clic con el botón derecho y pegue el token después de Valor y haga clic en Autorizar Observe que el nombre es X-API-KEY.
Esta información junto con el token se usará más adelante en Postman.
g. Cierre el cuadro de diálogo Autorizaciones disponibles y vuelva a la lista de API. Observe que los bloqueos de varias de las API
han cambiado ahora. Estas API ya están disponibles para su uso.
h. Haga clic en la barra de API POST /LoginViaBasic para cerrar la ventana.

Paso 9: Añada libros mediante la API POST /books.


a. Haga clic en la API POST /books.
b. Observe en Parámetros que la carga útil es requerida. Esto significa que esta API debe requerir información para este
parámetro en el formato especificado por el tipo de contenido Parameter, que es JSON.
c. Haga clic en Probar.
d. Modifique el ID, el título y el autor con la información que se muestra a continuación.
{
«id»: 4,
«título»: "Fundamentos de IPv6«,
«author»: "Rick Graziani»
}
e. Haga clic en Ejecutar.
f. Compruebe que la publicación se ha realizado exitosamente en la respuesta del servidor. Un código de 200 significa que la
publicación fue un éxito. Usted debería ver el libro que acaba de agregar en el cuerpo de la respuesta junto con un nuevo ID.
También verá información actualizada sobre CURL y la URL de solicitud.
g. Para añadir otro libro, modifique el ID, el título y el autor con la información que se muestra a continuación.
{
"ID": 5.
«título»: "31 días antes de su examen CCNA«,
«author»: "Allan Johnson»
}
h. Haga clic en Ejecutar.
i. Verifique que la publicación se ha realizado exitosamente en la respuesta del servidor. Un código de 200 significa que la
publicación fue un éxito. Usted debería ver el libro que acaba de agregar en el cuerpo de la respuesta junto con un nuevo id.
También verá información actualizada sobre CURL y la URL de solicitud.
Nota: Si tienes un código 401,comprueba el texto del cuerpo de la respuesta. Lo más probable es que haya recibido una
respuesta de «error»: «Clave API inválida». Esto se debe a que usted no ingresó todos los caracteres para su clave API. O
posiblemente, agregar un espacio innecesario. Vuelva al paso anterior y repita el proceso de autorización.
j. Haga clic en la barra de API POST /books para cerrar la ventana.
k. Usted puede verificar los libros que se agregaron a la página de Nuestros libros. Vuelva a la pestaña Biblioteca escolar en su
navegador (http://library.demo.local) y actualice la página. Tenga cuidado de no cerrar la pestaña API de la biblioteca escolar. Si
lo hace, tendrá que volver a autenticarse.

Paso 10: Enumera libros con la API GET /books.


a. Vuelva a la pestaña API de la biblioteca escolar en el navegador. Haga clic en la API GET /books.
b. Haga clic en Probar Si usted ve el botón Cancelar en rojo, entonces ya está en el modo Prueba.
c. Haga clic en Ejecutar
d. Debajo de Respuesta del servidor en el cuerpo de la respuesta, ahora verá los dos libros que agregó. Observe que cada uno
tiene una identificaciónúnica.
[
{
«ID»: 0,
"Título": "Fundamentos del enrutamiento IP",
«author",: «Mark A. Sportack»
},
{
"id":1
«Título» «Python para tontos»
«author» «Stef Maruch Aahz Maruch»
},
{
"ID"2
«título»: «Linux para Trabajadores de NET»
«author» «Cisco Systems Inc.»
},
{
«id» 3,
"título» «NetAcad: 20 años de aprendizaje en línea"
«author» «Cisco Systems Inc.»
},
{
«id»: 4,
"título»: "Fundamentos de IPv6",
"author»: "Rick Graziani"
},
{
"id": 5.
"título»: "31 días antes de su examen CCNA",
«author»: "Allan Johnson»
}
]
e. Haga clic en la barra de la API GET /books para cerrar la ventana.

Paso 11: Enumera un libro específico utilizando la API GET /books {id}.
a. Haga clic en la API GET /books {id}. Observe que esta API requiere el id como parámetro.
b. A la derecha de Parámetros, haga clic en el botón Probar.
c. En Parámetros, escriba 4 para el identificador requerido.
d. Haga clic en Ejecutar Observe la información proporcionada por CURL y URL de solicitud.
 CURL - Este es el comando CURL para realizar la misma función usando CURL.
 URL de solicitud - Esta es la URL que se puede usar para obtener la misma información usando Postman y Python.
Compruebe que el resultado fue correcto en la respuesta del servidor. Un código de 200 significa que la publicación fue un
éxito. En el cuerpo de la respuesta verá el libro que solicitó con el id de 4.
{
«id»: 4,
«título»: "Fundamentos de IPv6«,
«author»: "Rick Graziani»
}
e. Haga clic en la barra de la API GET /books {id} para cerrar la ventana.
Paso 12: Elimine un libro específico con la API DELETE /books {id}.
a. Haga clic en la API DELETE /books {id}. Observe que esta API requiere el id como parámetro.
b. Haga clic en Probar
c. En Parámetros, escriba 4.
d. Haga clic en Ejecutar
e. Verifique que la eliminación se realizó correctamente en la respuesta del servidor. Un código de 200 significa que la publicación
fue un éxito. En el cuerpo de la respuesta usted verá el libro que eliminó con el id de 4.
{
«id»: 4,
«título»: "Fundamentos de IPv6«,
«author»: "Rick Graziani»
}
f. Haga clic en la barra de la API DELETE /books {id} para cerrar la ventana.

Paso 13: Enumera libros con la API GET /books.


a. Haga clic en el API GET /books
b. Haga clic en Probar. Si usted ve el botón Cancelar en rojo, entonces ya estás en el modo Prueba.
c. Haga clic en Ejecutar.
d. En Respuesta del servidor en el cuerpo de la respuesta, ya no verá el libro con id o 4.
[
{
«id»: 0,
"Título": "Fundamentos del enrutamiento IP",
«author",: «Mark A. Sportack»
},
{
"id":1
«Título» «Python para tontos»
«author» «Stef Maruch Aahz Maruch»
},
{
"id"2
«título»: «Linux para Networkers»
«author» «Cisco Systems Inc.»
},
{
«id» 3,
«título» «NetAcad: 20 años de aprendizaje en línea»
«author» «Cisco Systems Inc.»
},
{
"id": 5.
«título»: "31 días antes de su examen CCNA«,
«author»: "Allan Johnson»
}
]
Nota: No cerrar la pestaña API de la biblioteca escolar en el navegador Chromium. Usted utilizará la documentación de la API en la
siguiente parte.

Parte 3: Usar Postman para realizar llamadas API al Simulador de API


En esta parte, usted usará Postman para realizar las mismas llamadas API que realizó en la documentación de la API de la biblioteca
de estudiantes. Postman es una herramienta útil cuando un sitio web de desarrolladores de API no está disponible, al tiempo que
proporciona la habilidad de guardar, organizar y reutilizar API fácilmente.

Paso 1: Abra Postman.


Haga doble clic en el icono de Postman en el escritorio normalmente, iniciaría sesión en Postman. Sin embargo, no es necesario
obtener una cuenta e iniciar sesión en Postman para laboratorios en este curso.

Paso 2: Enumere los libros utilizando la API GET /books.


a. En la ventana principal junto a la pestaña Launchpad, haga clic en el icono más «+» para crear una solicitud sin título. De forma
predeterminada, esta será una solicitud GET.
b. Haga clic en la flecha abajo situada junto a GET para ver las diferentes operaciones de API, incluidas GET, POST y ELIMINAR
(DELETE). Deje la selección en GET. Haga clic en la flecha hacia arriba situada junto a Obtener para cerrar la lista.
c. Introduzca la URL solicitada.
1) Vuelva a la pestaña API de la biblioteca escolar en Chromium y, si es necesario, expanda la API GET /books.
2) En Solicitar URL, seleccione, haga clic con el botón derecho y Copiar la URL en el portapapeles:
http://library.demo.local/api/v1/books
3) Vuelva a Postman y pegue la URL junto a GET donde indica, «Introducir URL de solicitud».
Nota: Si pegando agrega una línea debajo de la URL, elimine la línea adicional.
d. Haga clic en Send (Enviar). Para verificar que la solicitud de API fue correcta, ahora verá una respuesta que incluye el código de
estado 200 OK en verde. Desplácese hacia abajo hasta la sección Cuerpo para ver la respuesta. Observe que el valor
predeterminado es Pretty y JSON.
[
{
«ID»: 0,
"Título": "Fundamentos del enrutamiento IP",
«author",: «Mark A. Sportack»
},
{
"ID":1
«Título» «Python para principiantes»
"author» «Stef Maruch Aahz Maruch"
},
{
"ID"2
«título»: «Linux para Trabajadores de NET»
«author» «Cisco Systems Inc.»
},
{
«id» 3,
«título» «NetAcad: 20 años de aprendizaje en línea»
«author» «Cisco Systems Inc.»
},
{
"ID": 5.
«título»: "31 días antes de su examen CCNA«,
«author»: "Allan Johnson»
}
]
Nota: Puede guardar la salida JSON en un archivo usando el botón Guardar respuesta encima de la salida. Esto no es requerido
para este laboratorio.

Paso 3: Obtenga un token usando la API POST /LoginViaBasic.


a. En la ventana principal, haga clic en el icono más «+» para crear una nueva solicitud sin título.
b. Haga clic en la flecha hacia abajo junto a GET y seleccione POST.
c. Introduzca la URL requerida
1) Vuelva a la pestaña API de la biblioteca escolar en Chromium y expanda la API POST /LoginViaBasic, si es necesario.
2) En Solicitar URL, seleccione, haga clic con el botón derecho y Copiar la URL en el portapapeles:
http://library.demo.local/api/v1/loginViaBasic
Nota: Si la URL de solicitud ya no se muestra, es probable que haya cerrado y vuelto a abrir la página de documentación
de la API de la biblioteca escolar y ya no esté autenticada. Haga clic en Probar, luego Ejecutar, y luego volver a autenticar
con el nombre de usuario cisco y contraseña Cisco123!.
3) Vuelva a Postman y pegue la URL junto a POST donde dice «Introducir URL de solicitud».
Nota: Si pegando agrega una línea debajo de la URL, elimine la línea adicional.
d. Haga clic en Autorización Dentro de esta área, complete lo siguiente:
1) En la lista desplegable de Tipo, elija Autenticación (Auth) básica.
2) Para los campos Nombre de usuario y Contraseña, rellene lo siguiente:
 Nombre de usuario: cisco
 Contraseña: Cisco123!
e. Haga clic en Send (Enviar).
f. Si es necesario, desplácese hacia abajo hasta la sección Cuerpo para ver su nuevo token token. Su token será diferente de la
que se muestra aquí.
{
«token»: «Cisco|5xSUHYFDVIAOCRV0LQWVSDCJJAWWJG18VMML6U2LM1i»
}

Paso 4: Añadir un libro mediante la API POST /books.


Ahora debe agregar el libro Fundamentos de IPv6 que eliminó en la Parte 2 cuando utilice la función Probar en la documentación de
la API de la Biblioteca escolar.
a. En la ventana principal, haga clic en el icono más «+» para crear una solicitud sin título.
b. Haga clic en la flecha hacia abajo junto a GET y seleccione POST.
c. Introduzca la URL solicitada.
1) Vuelva a la pestaña API de la biblioteca escolar en Chromium y expanda la API POST /books.
2) En Solicitar URL, seleccione, haga clic con el botón derecho y Copiar la URL en el portapapeles:
http://library.demo.local/api/v1/books
Nota: Si la URL de solicitud ya no se muestra, probablemente canceló Pruébalo. Haga clic en Probar y, a continuación,
Ejecutar para mostrar la URL de solicitud.
3) Vuelva a Postman y pegue la URL junto a POST donde dice «Introducir URL de solicitud».
Nota: Si pegando agrega una línea debajo de la URL, elimine la línea adicional.
d. Haga clic en Autorización Dentro de esta área, complete lo siguiente:
1) En la lista desplegable Tipo, elija Clave API.
2) En el campo Clave, escriba X-API-KEY.
Nota: Recuerde que vio X-API-KEY en la página web de la API de la biblioteca escolar cuando obtuvo un token
seleccionando el botón verde Autorizar.
3) Vuelva a la pestaña Post en Postman y copie el token que recibió en el paso 3. Asegúrese de incluir todo dentro de las
comillas. Su token será diferente de la que se muestra aquí.
Ejemplo: Cisco|5xSUHYFDVIAOCRV0LQWVSDCJJAWWJG18VMML6U2LM1i
4) Vuelve a la segunda pestaña Post en Postman. Pegar el token en el campo Valor
e. En la misma fila con la Autorización, haga clic en Cuerpo. Esta sección le permitirá a usted elegir el formato de su entrada.
 Haga clic en el botón de radio RAW.
 Haga clic en Texto y cambie esta opción a JSON.
f. En el área de entrada verá el número 1, para “línea 1”. Ingrese el siguiente objeto JSON.
{
«id»: 4,
«título»: "Fundamentos de IPv6«,
"author»: «Rick Graziani",
"isbn»: «978 158144778"
}
g. Haga clic en Send (Enviar).
h. Para verificar que la solicitud de API fue correcta, ahora verá una respuesta que incluye el código de estado 200 OK en verde.

Paso 5: Verifique el libro adicional con la API Get /books.


a. Vuelva a la primera pestaña GET. Como puede ver, Postman hace que sea fácil cambiar entre diferentes llamadas de API.
b. Haga clic en Send (Enviar).
c. Para verificar que la solicitud de API fue correcta, ahora usted verá una respuesta que incluye el código de estado 200 OK en
verde.
d. Haga clic en Cuerpo para ver la respuesta. Observe que el predeterminado es Pretty y JSON.
[
{
«ID»: 0,
"Título": "Fundamentos del enrutamiento IP",
«author",: «Mark A. Sportack»
},
{
"ID":1
«Título» «Python para tontos»
«author» «Stef Maruch Aahz Maruch»
},
{
"ID"2
«título»: «Linux para Trabajadores de NET»
«author» «Cisco Systems Inc.»
},
{
«id» 3,
«título» «NetAcad: 20 años de aprendizaje en línea»
"author» «Cisco Systems Inc."
},
{
«id»: 4,
«título»: "Fundamentos de IPv6«,
«author»: "Rick Graziani»
}
{
"id": 5.
"título»: "31 días antes de su examen CCNA",
"author»: "Allan Johnson"
},
]

Paso 6: Utilice parámetros adicionales con el API Get /books.


a. Vaya al sitio web de la API de la biblioteca escolar . Desplácese hacia arriba hasta GET /books API y expandirlo, si es necesario.
Observe los parámetros que están disponibles:
o IncludeISBN: Incluye en los resultados los números ISBN. Predeterminado (Default)=Falso
o SortBy: Ordena los resultados utilizando el parámetro especificado. Predeterminado (Default)=ID
o Autor: Devolver sólo los libros del Autor dado.
o Page : Se utiliza para especificar un número de página.
b. Haga clic en Probar. Si ve un botón Cancelar en rojo, entonces no necesita seleccionar este botón.
c. Bajo parámetros:
 Haga clic en IncludeISBN y seleccione true
 Haga clic en OrdenarPor y seleccione autor
d. Haga clic en Ejecutar.
e. En el cuerpo de la respuesta verá la lista de libros ahora ordenados por autor e incluyendo los ISBN.
[
{
"id": 5.
"título": "31 días antes de su examen CCNA",
"author": "Allan Johnson"
},
{
"id"2
"título": "Linux para Trabajadores de Net"
"author": Cisco Systems Inc.",
"isbn": "000-0000000123"
},
{
«id» 3,
"título" "NetAcad: 20 años de aprendizaje en línea"
"author": "Cisco Systems Inc.",
"isbn": «000-0000001123"
},
{
"ID": 0,
"Título": "Fundamentos del enrutamiento IP",
"author": «Mark A. Sportack",
"isbn": "978-1578700714"
},
{
"id": 4,
"título": "Fundamentos de IPv6",
"author": "Rick Graziani",
"isbn": "978 1587144778"
},
{
"ID":1
"Título": "Python para principiantes"
"author": "Stef Maruch Aahz Maruch",
"isbn": "978-0471778646"
}
]
Observe que la URL de solicitud ahora incluye los parámetros. Verás esto de nuevo en Postman.
http://library.demo.local/api/v1/books?includeIsBN=true&sortBy=Autor
f. Vuelva a Postman y vaya a la primera pestaña API, GET http://library.demo.local/api/v1/books. Ahora incluirá algunos de los
parámetros del sitio web de Librería Escolar de API.
g. Haga clic en Params. Verá en los cuadros de entrada de parámetros de consulta para KEY y VALUE. Ingrese la siguiente
información:
 En KEY, escriba IncludeISBN y en Valor ingrese Cierto (true)
Observe que una marca de verificación se incluirá automáticamente a la izquierda del valor y se agregará una nueva
fila.
 En KEY, escriba SortBy y en Valor escriba autor
Observe que al introducir estos parámetros de consulta, ha actualizado la URL original junto a GET. Esta es la misma URL de
solicitud que vio en el sitio web de School Library API para esta misma llamada de API. Esta es la URL que usará Postman, con
estos parámetros de consulta al realizar la llamada API.
http://library.demo.local/api/v1/books?includeIsBN=true&sortBy=Autor
h. Haga clic en Send (Enviar).
Nota en el cuerpo, ahora muestra la misma lista de libros, ordenados por autor e incluyendo los ISBN que vió en el sitio web de
la API de la biblioteca escolar.
[
{
"ID": 5.
"título": "31 días antes de su examen CCNA",
"author": "Allan Johnson"
},
{
"id"2
"título": "Linux para Trabajadore de Net"
"author": "Cisco Systems Inc.",
"isbn": "000-0000000123"
},
{
"id" 3,
"título" "NetAcad: 20 años de aprendizaje en línea"
"author": "Cisco Systems Inc.",
"isbn": "000-0000001123"
},
{
"ID": 0,
"Título": "Fundamentos del enrutamiento IP",
"author": "Mark A. Sportack",
"isbn": "978-1578700714"
},
{
"id": 4,
"título": "Fundamentos de IPv6",
"author": "Rick Graziani",
"isbn": "978 1587144778"
},
{
"ID":1
"Título" "Python para tontos"
"author": "Stef Maruch Aahz Maruch",
"isbn": "978-0471778646"
}
]
Fin del
Revisión y entrega

Una vez finalizada la actividad, debe dar aviso a su docente para la correspondiente revisión y/o entrega de recursos según
el medio definido.

También podría gustarte