Solicitar tu primera API en Atajos
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 del pronóstico de Dark Sky requiere que la solicitud de URL tenga el siguiente formato:
https://api.darksky.net/forecast/[YOUR_SECRET_KEY]/[LAT],[LONG]
El texto entre paréntesis se rellenará con una clave API y la ubicación para la que deseas recibir la información del pronóstico.
En la app Atajos, coloca tu clave de API de Dark Sky en la primera acción Texto, que se transfiere a la acción URL como una variable. Los valores
LATITUDyLONGITUDya están ajustados como37.8267y-122.4233, que son las coordenadas de la Isla de Alcatraz en San Francisco. (Puedes cambiar esos valores a una ubicación diferente).Intenta utilizar la acción “Obtener ubicación actual” y colocarla como una variable mágica ajustada con respecto a la latitud y a la longitud en la acción URL para obtener la información del tiempo local siempre que ejecutes el atajo.
Realizar la solicitud API con la acción “Obtener contenido de URL”
En el editor de atajos de la app Atajos, ajusta “Obtener contenido de URL” en Avanzado.
Las siguientes opciones para los tipos de solicitudes API que puedes hacer pasan a estar disponibles:
OBTENERte permite recuperar datos.PUBLICARte permite crear datos nuevos.PONERte permite actualizar datos reemplazándolos.PATCHte permite actualizar datos modificándolos.ELIMINARte permite eliminar un objeto especificado en la solicitud de la URL.
Para este ejemplo, usa una solicitud
OBTENERpara recuperar datos de Dark Sky API.Ahora que la acción URL tiene tu solicitud y que la acción “Obtener contenido de URL” está configurada como
OBTENERdatos, ya puedes realizar la solicitud API.Nota: Si la acción “Obtener contenido de URL” ha cambiado a
PUBLICAR,PONERoPARCHE, 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.Pulsa
para probar el atajo (la acción “Vista rápida” del atajo te permite previsualizar los datos que devuelve la API).
A primera vista, la API parece devolver un montón de texto. Los datos del tiempo 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 Dark Sky API, consulta Introducción al uso de JSON en Atajos.