Solicitarea primului API în Scurtături
Pentru a solicita primul API, trebuie să creați URL‑ul care indică spre “punctul final” al API‑ului cu care doriți să comunicați și apoi să transmiteți acest URL către acțiunea “Obțineți conținutul URL-ului”. La executarea scurtăturii, această acțiune realizează solicitarea API.
Construirea solicitării API
Punctul final de prognoză Dark Sky necesită formatarea unei solicitări URL după cum urmează:
https://api.darksky.net/forecast/[CHEIA_DVS_SECRETĂ]/[LAT],[LONG]
Textul din parantezele pătrate va fi completat cu o cheie API și cu localizarea pentru care doriți datele de prognoză.
În aplicația Scurtături, plasați cheia dvs. API de la Dark Sky în prima acțiune Text, care este transmisă către acțiunea URL ca variabilă. Valorile
LATșiLONGsunt deja fixate la37.8267și-122.4233, care sunt coordonatele Insulei Alcatraz din San Francisco. (Puteți schimba valorile respective pentru a indica alt loc.)Încercați să utilizați acțiunea “Obțineți localizarea curentă” și să o plasați ca variabilă magică fixată la Latitudine și Longitudine în acțiunea URL pentru a obține datele meteo locale de fiecare dată când executați scurtătura.
Efectuarea solicitării API cu acțiunea “Obțineți localizarea curentă”
În editorul de scurtături din aplicația Scurtături, configurați acțiunea “Obțineți conținutul URL-ului” la Avansat.
Devin disponibile următoarele opțiuni pentru tipurile de solicitări API pe care le puteți realiza:
GETvă permite să preluați pentru a fi citite date de la un API.POSTvă permite să creați date noi.PUTșiPATCHvă permit să actualizați datele prin înlocuirea sau, respectiv, modificarea acestora.DELETEvă permite să eliminați un obiect specificat în solicitarea URL.
Pentru acest exemplu, folosiți o solicitare
GETpentru a prelua date de la API‑ul Dark Sky.După ce acțiunea URL‑ului include solicitarea dvs., iar acțiunea “Obțineți conținutul URL-ului” este configurată la
GETpentru a prelua date, sunteți gata să realizați solicitarea API.Notă: Atunci când acțiunea “Obțineți conținutul URL-ului” este schimbată la
POST,PUTsauPATCH, este adăugat un nou parametru numit “Corp solicitare”. “Corp solicitare” vă permite să trimiteți un JSON, un formular sau un fișier către API ca parte a solicitării dvs. Aceasta vă permite să introduceți date noi, manual sau prin utilizarea unor variabile, pentru a putea trimite datele către API pentru crearea, înlocuirea sau modificarea unei intrări.Apăsați pe
pentru a testa scurtătura (acțiunea “Privire rapidă” din scurtătură vă permite să previzualizați datele returnate de API).
Felicitări, ați realizat prima dvs. solicitare API folosind aplicația Scurtături.
La prima vedere, API‑ul pare să returneze mult text formatat în mod ciudat. La o analiză mai detaliată, puteți vedea că textul conține informațiile de prognoză meteo. Aceste date meteo sunt codate în JSON, prescurtarea de la JavaScript Object Notation.
Pentru a afla informații despre lucrul cu JSON și pentru a continua exemplul API‑ului Dark Sky, consultați Despre utilizarea JSON în Scurtături.