Slanje prvog API zahtjeva u Prečacima
Želite li zatražiti svoj prvi API, izradite URL usmjeren na “krajnju točku” za API s kojom želite uspostaviti interakciju, a zatim proslijedite taj URL radnji Preuzimanje sadržaja URL-a. Kada se prečac pokrene, ova radnja izrađuje API zahtjev.
Izrada API zahtjeva
URL zahtjev za krajnju točku vremenske prognoze Dark Sky mora biti formatiran ovako:
https://api.darksky.net/forecast/[YOUR_SECRET_KEY]/[LAT],[LONG]
U tekst u zagradama unijet će se API ključ i lokacija za koju želite dobiti podatke o prognozi.
U aplikaciji Prečaci postavite svoj API ključ iz prognoze Dark Sky u prvu radnju Tekst, koja se prenosi u radnju URL kao varijabla. Vrijednosti
ŠIR
iDULJ
već su postavljeni na37.8267
i-122.4233
, koordinate otoka Alcatraz u San Franciscu. (Te vrijednosti možete promijeniti na drugu lokaciju.)Pokušajte upotrijebiti radnju Dohvati trenutačnu lokaciju i postaviti je kao Magičnu varijablu podešenu na Širinu i Duljinu u radnji URL-a kako biste preuzeli lokalne podatke o vremenskoj prognozi pri svakom pokretanju prečaca.
Izvršavanje API zahtjeva radnjom Preuzimanje sadržaja URL-a
U uredniku prečaca aplikacije Prečaci podesite Dohvati sadržaj URL-a na Napredno.
Možete osigurati dostupnost sljedećih opcija za vrste API zahtjeva:
Opcija
PREUZIMANJE
omogućuje dohvaćanje podataka za čitanje s API-ja.Opcija
OBJAVLJIVANJE
omogućuje izradu novih podataka.Opcije
POSTAVLJANJE
iKONFIGURACIJA
omogućuju ažuriranje podataka njihovom zamjenom, odnosno izmjenom.Opcija
BRISANJE
omogućuje uklanjanje objekta određenog URL zahtjevom.
Primjerice, upotrijebite zahtjev
PREUZIMANJE
kako biste dohvatili podatke iz API-ja Dark Sky.Kada URL primi vaš zahtjev, a radnja Preuzimanje sadržaja URL-a je postavljena na
DOHVATI
podatke, spremni ste za sastavljanje API zahtjeva.Napomena: Kada se radnja Dohvati sadržaj radnje URL-a prebaci na
OBJAVI
,STAVI
, iliZAKRPAJ
, dodaje se novi parametar naziva Zatraži tijelo. Tijelo zahtjeva omogućuje vam da u okviru zahtjeva šaljete JSON, oblik ili datoteku. Time vam se omogućuje ručni unos novih podataka ili unos s pomoću varijabli kako biste API-ju mogli slati podatke za izradu, zamjenu ili izmjenu unosa.Dodirnite kako biste testirali prečac (radnja Brzi pregled u prečacu omogućuje vam pregled povratnih podataka API-ja).
Čestitamo, izradili ste svoj prvi API zahtjev s pomoću Prečaca.
Na prvi pogled čini se da API povratno šalje mnogo neobično formatiranog teksta. Ako pogledate pažljivije, vidjet ćete da tekst sadržava informacije o vremenskoj prognozi. Ti podaci o vremenskog prognozi kodirani u formatu JSON, što označava JavaScript Object Notation.
Želite li saznati više o radu s JSON formatom i nastaviti rad s primjerom API-ja za Dark Sky, pogledajte O uporabi JSON formata u Prečacima.