Sol·licitar la teva primera API a l’app Dreceres
Per sol·licitar la teva primera API, has de crear l’URL que apunta al “punt final” de l’API amb el qual vols parlar, i després, passa aquest URL a l’acció “Obtenir el contingut de l’URL”. Quan s’executa la drecera, aquesta acció fa la sol·licitud API.
Crear la sol·licitud de l’API
La previsió meteorològica de Dark Sky requereix que la sol·licitud URL tingui aquest format:
https://api.darksky.net/forecast/[YOUR_SECRET_KEY]/[LAT],[LONG]
El text entre claudàtors serà una clau API i la ubicació de la qual vols dades de previsió meteorològica.
A l’app Dreceres, posa la teva clau API de Dark Sky a la primera acció Text, que es passa a l’acció URL com a variable. Els valors
LATiLONGja estaràn definits en37.8267i-122.4233, lescoordenades de l’illa de la presó d’Alcatraz a San Francisco. (Pots canviar aquests valors pels d’una altra ubicació).Prova d’utilitzar l’acció “Obtenir la ubicació actual” i situar‑la com a variable màgica definida en la latitud i la longitud de l’acció URL per obtenir les dades meteorològiques sempre que executis la drecera.
Fer la sol·licitud API amb l’acció “Obtenir el contingut de l’URL”
A l’editor de dreceres de l’app Dreceres, defineix “Obtenir el contingut de l’URL” en Avançat.
Aquestes són les opcions de tipus de sol·licituds API que pots fer:
OBTENIRpermet obtenir dades.PUBLICARpermet crear noves dades.POSARpermet actualitzar les dades substituint‑les.FER UN PEDAÇpermet actualitzar les dades modificant‑les.ELIMINARpermet eliminar un objecte especificat a la sol·licitud URL.
Per aquest exemple, utilitza una sol·licitud
OBTENIRper recuperar dades de l’API Dark Sky.Ara que l’acció URL té la teva sol·licitud i l’acció URL “Obtenir el contingut de l’URL” està definit en
OBTENIR, ja pots fer la sol·licitud API.Nota: Quan l’acció “Obtenir el contingut de l’URL” es canvia a
PUBLICAR,POSARoFER UN PEDAÇ, s’afegeix un nou paràmetre anomenat “Sol·licitar el cos”. “Sol·licitar el cos” permet enviar un JSON, un Formulari o un Arxiu a l’API com a part de la teva sol·licitud. Això et permet introduir noves dades manualment o mitjançant variables i pots enviar les dades a l’API per crear, substituir o modificar una entrada.Prem
per provar la drecera (l’acció “Vista ràpida” a la drecera permet previsualitzar les dades que retorna l’API).
A simple vista, sembla que l’API retorni un text fet un batibull. Aquestes dades meteorològiques estan codificades en JSON, la sigla en anglès de Notació d’Objecte JavaScript.
Per aprendre a treballar amb JSON i continuar amb l’exemple de l’API Dark Sky, consulta Introducció a la utilització d’arxius JSON a l’app Dreceres.