Solicitar tu primera API en Atajos
Para solicitar tu primera API, crea la URL que apunta al "punto final" de la API con la cual te quieres comunicar y luego pasa esa URL a la acción "Obtener contenido de URL". Cuando se ejecute el atajo, esta acción crea la solicitud de API.
Crear la solicitud de API
El punto final del pronóstico de Dark Sky requiere una solicitud de URL con el siguiente formato:
https://api.darksky.net/forecast/[TU_CLAVE_SECRETA]/[LAT],[LONG]
El texto en paréntesis se llenará con una clave API y la ubicación del lugar del cual quieres obtener el pronóstico del clima.
En la app Atajos, coloca tu clave de API de Dark Sky en la primera acción Texto, la cual se pasa a la acción Dirección URL como una variable. Los parámetros
LATandLONGya están establecidos en37.8267y-122.4233, las coordenadas de la Isla de Alcatraz en San Francisco (puedes cambiar esos valores a una ubicación diferente).Intenta usar la acción "Obtener ubicación actual" y colócala como variable mágica en Latitud y Longitud en la acción Dirección URL para obtener los datos del clima locales cada vez que ejecutes el atajo.
Realizar una solicitud de API con la acción "Obtener contenido de URL"
En el editor de atajos de la app Atajos, elige Avanzado en "Obtener contenido de URL".
Se mostrarán las siguientes opciones de tipos de solicitudes de API que puedes realizar:
OBTENERte permite obtener datos.PUBLICARte permite crear datos nuevos.PONERte permite actualizar datos mediante su reemplazo.PARCHEte permite actualizar datos mediante su edición.ELIMINARte permite eliminar un objeto determinado en la solicitud URL.
Para este ejemplo, usa una solicitud
OBTENERpara obtener datos de la API de Dark Sky.Ahora que la acción Dirección URL tiene tu solicitud y configuraste la acción "Obtener contenido de URL" para
OBTENERdatos, estás listo para realizar tu solicitud de API.Nota: cuando la acción "Obtener contenido de URL" cambia a
PUBLICAR,PONERoPATCH, se agrega un nuevo parámetro llamado "Solicitar cuerpo". "Solicitar cuerpo" te permite enviar JSON, un Formulario o un Archivo a la API como parte de tu solicitud. Esto te permite ingresar datos manualmente o mediante variables para enviar datos a la API con el objetivo de crear, reemplazar o modificar una entrada.Toca
para probar el atajo (la acción "Vista rápida" en el atajo te permite obtener una vista previa de los datos que la API devuelve).
A primera vista, parece que la API devuelve una mezcla incomprensible de texto . Estos datos del clima están codificados en JSON, que significa notación de objetos JavaScript.
Para aprender a trabajar con JSON y continuar con el ejemplo de la API de Dark Sky, consulta Introducción al uso de JSON en Atajos.