Vytvoření prvního požadavku API ve Zkratkách
Chcete‑li si vyžádat své první API, vytvořte URL odkazující na „koncový bod“ API, s nímž chcete komunikovat, a pak toto URL předejte do akce Načíst obsah URL. Po spuštění zkratky tato akce vytvoří požadavek API.
Vytvoření požadavku API
Koncový bod pro předpověď služby Dark Sky vyžaduje požadavek URL v následujícím formátu:
https://api.darksky.net/forecast/[VÁŠ_TAJNÝ_KLÍČ]/[LAT],[LONG]
Místo textu v hranatých závorkách bude zadán klíč API a poloha, pro kterou chcete získat data předpověď.
V aplikaci Zkratky umístěte svůj API klíč z Dark Sky do první akce Text, který je pak pomocí proměnné předán akci URL. Parametry
LATaLONGjsou zde už nastaveny na hodnoty37,8267a-122,4233, což jsou souřadnice ostrova Alcatraz v San Francisku. (Tyto hodnoty však můžete změnit na jinou polohu.)Zkuste použít akci Zjistit aktuální polohu a umístit ji do zkratky jako automatickou proměnnou nastavenou tak, že udává zeměpisnou šířku a délku pro akci URL – tímto způsobem získáte data o počasí, ať už tuto zkratku spustíte kdekoli.
Provedení požadavku API s akcí Načíst obsah URL
V editoru zkratek aplikace Zkratky nastavte pro akci Načíst obsah URL na Pokročilé.
Pro typy požadavků API, které lze zadat, budou zpřístupněny následující volby:
GETumožňuje načíst data z API pro čtení.POSTumožňuje vytvořit nová data.PUTaPATCHvám umožňují aktualizovat data nahrazením, resp. úpravou.DELETEumožňuje odstranit objekt specifikovaný v URL požadavku.
V tomto příkladu načtěte data z API služby Dark Sky pomocí požadavku
GET.Nyní, když akce URL obsahuje váš požadavek a akce Načíst obsah URL je nastavena na
GETdata, jste připraveni na vytvoření požadavku API.Poznámka: Když je akce Načíst obsah URL přepnuta na
POST,PUTneboPATCH, bude přidán nový parametr s názvem Tělo požadavku. Akce Tělo požadavku umožňuje odeslat do API jako součást vašeho požadavku také JSON, formulář nebo soubor. Díky tomu můžete zadat nová data ručně nebo pomocí proměnných, takže můžete do API odeslat data pro vytvoření, nahrazení nebo úpravu položky.Chcete‑li testovat zkratku, klepněte na
(zobrazit náhled dat, která vrátí API, vám ve zkratce umožní akce Rychlý náhled).
Gratulujeme, právě jste prostřednictvím aplikace Zkratky vytvořili svůj první požadavek API.
Při prvním pohledu API vrací spoustu podivně formátovaného textu. Při bližším prozkoumání ale zjistíte, že text obsahuje informace pro požadovanou předpověď počasí. Tato data o počasí jsou zakódována ve formátu JSON, což je zkratka pro JavaScript Object Notation.
Informace o práci s formátem JSON a pokračování příkladu s API služby Dark Sky najdete v části Informace o JSON ve Zkratkách.