Solicitar tu primera API en Atajos en el iPhone o el iPad
Para solicitar tu primera API, crea la URL que se dirija al “punto final” de la API con la que quieres comunicarte y, a continuación, transfiere esa URL a la acción “Obtener contenido de URL”. Cuando el atajo se está ejecutando, esta acción realiza la solicitud API.
Crear la solicitud API
El punto final de Typicode requiere que la solicitud de URL tenga el siguiente formato:
https://jsonplaceholder.typicode.com/[RESOURCE]
El texto que aparece entre corchetes es el recurso al que te gustaría acceder. Typicode proporciona muchos ejemplos distintos de solicitudes de prueba. Este ejemplo utilizará https://jsonplaceholder.typicode.com/users para solicitar una lista de usuarios.
En la app Atajos
del iPhone o iPad, añade la solicitud a la URL.La solicitud de
usersdevolverá una lista de usuarios.Puedes acotar tu búsqueda especificando un usuario concreto por su identidad:
https://jsonplaceholder.typicode.com/users/6. Esto devolverá el usuario cuya identidad sea 6.La mayoría de las API permiten que las solicitudes utilicen el siguiente formato:
https://jsonplaceholder.typicode.com/users?username=Bret. El signo de interrogación “?” da pie a la solicitud, que busca ítems que utilicen los pares clave-valor. En este ejemplo, la solicitud?username=Bretbusca un usuario cuyo nombre de usuario sea Bret.Consulta la documentación de la API para saber qué búsquedas y solicitudes se pueden realizar.
Realizar la solicitud API con la acción “Obtener contenido de URL”
En la app Atajos
del iPhone o iPad, toca “Mostrar más” en la acción “Obtener contenido de URL”.Las siguientes opciones para los tipos de solicitudes API que puedes hacer pasan a estar disponibles:
GETte permite recuperar datos.POSTte permite crear datos nuevos.PUTte permite actualizar datos reemplazándolos.PATCHte permite actualizar datos modificándolos.DELETEte permite eliminar un objeto especificado en la solicitud de la URL.
Para este ejemplo, usa una solicitud
GET(obtener) para recuperar datos de la API Typicode.Ahora que la acción URL tiene tu solicitud y que la acción “Obtener contenido de URL” está configurada como
GET(obtener) datos, ya puedes realizar la solicitud API.Nota: Si la acción “Obtener contenido de URL” ha cambiado a
POST,PUToPATCH(PUBLICAR, PONER o PARCHE), se añade un nuevo parámetro llamado “Cuerpo de la solicitud”. El cuerpo de la solicitud te permite enviar a JSON un formulario o un archivo a la API como parte de tu solicitud. Esto te permite introducir nuevos datos manualmente o mediante el uso de variables para que puedas enviar datos a la API para crear, sustituir o modificar una entrada.Para probar el atajo, toca
.
A primera vista, la API parece devolver un montón de texto. Los datos están codificados en formato JSON, que son las siglas en inglés de Notación de Objetos de JavaScript.
Para obtener información sobre cómo trabajar con JSON y continuar con el ejemplo de la API Typicode, consulta Introducción al uso de JSON en Atajos en el iPhone y el iPad.