Vytvorenie prvej požiadavky API v apke Skratky
Ak chcete odoslať svoju prvú požiadavku API, vytvorte URL adresu odkazujúcu na „koncový bod“ rozhrania API, s ktorým chcete komunikovať, a potom túto URL adresu odovzdajte do akcie Získať obsah URL. Po spustení skratky vytvorí táto akcia požiadavku API.
Zostavenie požiadavky API
Koncový bod služby Dark Sky pre predpovede počasia vyžaduje požiadavku URL v nasledujúcom formáte:
https://api.darksky.net/forecast/[VÁŠ_TAJNÝ_KĽÚČ]/[LAT],[LONG]
Namiesto textu v hranatých zátvorkách je potrebné zadať kľúč API a miesto, pre ktoré chcete získať dáta predpovede.
V apke Skratky umiestnite kľúč API zo služby Dark Sky do prvej akcie Text, ktorá sa ako premenná odovzdáva do akcie URL. Parametre
LATaLONGuž sú nastavené na hodnoty37,8267a-122,4233, čo sú súradnice ostrova Alcatraz v San Franciscu. (Tieto hodnoty môžete zmeniť na iné miesto.)Skúste použiť akciu Získať aktuálnu polohu a umiestniť ju do skratky ako magickú premennú nastavenú tak, aby uvádzala zemepisnú šírku a dĺžku v akcii URL. Získate tak dáta o počasí na mieste, kde spustíte túto skratku.
Odoslanie požiadavky API s akciou Získať obsah URL
V editore skratiek apky Skratky nastavte akciu Získať obsah URL na možnosť Rozšírené.
Pre typy požiadaviek API, ktoré možno zadať, sa sprístupnia nasledujúce možnosti:
Požiadavka
GETumožňuje načítať dáta z rozhrania API na čítanie.Požiadavka
POSTumožňuje vytvoriť nové dáta.Požiadavky
PUTaPATCHumožňujú aktualizovať dáta nahradením, resp. úpravou.Požiadavka
DELETEumožňuje odstrániť objekt zadaný v požiadavke URL.
V tomto príklade načítate dáta z rozhrania API služby Dark Sky pomocou požiadavky
GET.Teraz, keď akcia URL obsahuje vašu požiadavku a akcia Získať obsah URL je nastavená na načítanie dát (
GET), ste pripravení na odoslanie požiadavky API.Poznámka: Po prepnutí akcie Získať obsah URL na požiadavku
POST,PUTaleboPATCHsa pridá nový parameter s názvom Telo požiadavky. Parameter Telo požiadavky umožňuje odoslať do rozhrania API ako súčasť požiadavky dáta JSON, formulár alebo súbor. Môžete tak zadať nové dáta manuálne alebo pomocou premenných, vďaka čomu môžete do rozhrania API odoslať dáta na vytvorenie, nahradenie alebo úpravu položky.Ak chcete skratku otestovať, klepnite na
(zobraziť náhľad dát, ktoré vráti rozhranie API, vám v skratke umožní akcia Rýchly náhľad).
Gratulujeme, práve ste prostredníctvom apky Skratky vytvorili svoju prvú požiadavku API.
Pri prvom pohľade rozhranie API vracia množstvo zvláštne formátovaného textu. Pri bližšom preskúmaní však zistíte, že text obsahuje informácie predpovede počasia. Tieto dáta o počasí sú zakódované vo formáte JSON, čo je skratka pre JavaScript Object Notation.
Informácie o práci s formátom JSON a pokračovanie príkladu s rozhraním API služby Dark Sky nájdete v téme Používanie formátu JSON v apke Skratky.