![](https://help.apple.com/assets/5D38A6ED0946225A2D640948/5D38A6F70946225A2D640958/cs_CZ/c10e8a839dc838a25d0feb0e9e428a0a.png)
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.
![Požadavek API Dark Sky, který obsahuje akci Text s tajným klíčem API, dále akci URL odkazující na koncový bod API s použitím proměnné Tajný klíč a nakonec akci Načíst obsah URL](https://help.apple.com/assets/5D38A6ED0946225A2D640948/5D38A6F70946225A2D640958/cs_CZ/22dae7009daf6596aa92f6fc5b287037.png)
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
LAT
aLONG
jsou zde už nastaveny na hodnoty37,8267
a-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:
GET
umožňuje načíst data.POST
umožňuje vytvořit nová data.PUT
umožňuje aktualizovat existující data přepsáním.PATCH
umožňuje existující data změnit.DELETE
umožň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
GET
data, jste připraveni na vytvoření požadavku API.Poznámka: Když je akce Načíst obsah URL přepnuta na
POST
,PUT
neboPATCH
, 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).
Na první pohled vypadají data vrácená rozhraním API jen jako nepřehledná změť textu. 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 Základy práce s formátem JSON ve Zkratkách.