Co znamená API? Příklady použití API

API znamená „Application Programming Interface“. A i když to může znít divně, pokud jste v programování noví, je snadné je pochopit, jakmile to rozložíte. Používáte je dokonce každý den při práci s mobilním telefonem, počítačem nebo při procházení internetu.

Software, včetně webových aplikací, mobilních aplikací a mnoha dalších programů, propojuje svět prostřednictvím internetu. Aby to však bylo efektivnější, musí mezi tímto softwarem existovat komunikační kanál - právě tam přichází API.

Zde vysvětlíme význam API a jak je používat.

Co je API?

Víte, jak můžete mimo jiné vidět videa na streamovacích platformách jako Netflix a YouTube? Je to možné, protože odesíláte požadavek prostřednictvím API.

Nebo jste si představili, jak jste schopni zaplatit za zboží, které kupujete v online obchodech, jako jsou Amazon a eBay? Je to také proto, že mezi vaší bankou a nákupními aplikacemi existuje komunikační kanál známý jako API.

To znamená, že API je rozhraní se sadou pravidel, která umožňují serveru vaší aplikace komunikovat se serverem poskytovatele řešení, takže můžete používat jejich prostředky. V podstatě definuje, jak aplikace nebo software navzájem komunikují.

V některých případech však API umožňuje vzájemnou výměnu dat. Příkladem je spojení, které existuje mezi vašimi bankovními aplikacemi a aplikacemi online obchodu.

API je jako posel. Připojuje se k serveru poskytovatele na jednom konci a také ukotví server klienta na druhém konci. Poté nabídne požadavek klienta na zdroj dat (server poskytovatele) a vrátí odpověď klientovi. Klientem je zde prohlížeč nebo vaše aplikace.

Háček však připojí vaši aplikaci k API. To je koncový bod API. Mnoho věcí se však odehrává za scénou. Vysvětlíme to dále.

Jak vám API pomáhají rychleji vyvíjet aplikace

API jsou chytřejší nástroj pro vytváření bezproblémových a robustních aplikací. Bez nich by vytváření sofistikovaných aplikací trvalo věky.

Představte si, že potřebujete svou aplikaci k provádění složitých operací, což je typ, jehož sestavení vyžaduje spoustu času a úsilí. A pak se někdo objeví s hotovým programem, který dělá přesně to, co chcete, a možná i lépe.

Jak to ale můžete připojit k aplikaci? Poskytovatel, který si to uvědomil, vám může trochu zabrat, pak vám řekl, že vytvořili rozhraní připojení (API), díky kterému se jejich i váš kód bezproblémově integrují.

Toto rozhraní (API) se připojuje k serveru obsahujícímu jejich kód. Potom vás přivádí zpět relevantní data z akce jejich skriptu.

Samozřejmě se nechcete nudit celým jejich zdrojovým skriptem. Kromě toho se většina moderních rozhraní API nyní spoléhá na standardizovanou technologii REST (Representational State Transfer). Díky tomu jsou vysoce škálovatelné a snadno se integrují, aniž byste se museli starat o to, co se odehrává uvnitř nebo o stavu vaší odpovědi nebo požadavku, protože jsou předem naformátované.

Tento článek nebude dále vysvětlovat REST API. Zatím se zaměřte na základy.

Zapojit váš kód do jejich je lepší nápad než psát od nuly. Chcete-li to však provést, musíte svůj kód připojit pomocí API, které poskytli. Jak to děláš? To je místo, kde na scénu vstupuje koncový bod API.

Co je koncový bod API?

Abychom to zjednodušili, poskytovatelé poté vložili URL, aby bylo připojení k jejich API bezproblémové. Taková URL je Koncový bod API. Díky tomu může vaše aplikace přistupovat k jejich serveru prostřednictvím API a komunikovat přímo se svým skriptem.

Jediné, co musíte udělat, je chytit koncový bod, vložit jej do kódu, zadávat s ním požadavky, přizpůsobit odpovědi a pak to funguje a je to vaše! Koncový bod API proto váže vaši aplikaci prostřednictvím API na řešení nebo zdroj dat.

Nakonec je mnoho programů, které nabízejí API, k dispozici v různých programovacích jazycích, takže nikdo nebude vyloučen z toho, že z nich budou mít prospěch.

Tímto způsobem se dostanete ke kódu rychleji a efektivněji s vědomím, že břemeno údržby API není na vás, ale na poskytovatelích dat nebo řešení.

Koncový bod API je tedy komunikační háček, který váže API na server prostředků na jednom okraji a spojuje ho se serverem příjemce na druhém konci.

To pak znamená, že nepotřebujete celý skript řešení, které chcete použít. Ale váš kód s ním nemůže navázat komunikaci, pokud se nepřipojí ke svému koncovému bodu API.

Pravidla integrace API

Neexistuje žádné tvrdé pravidlo pro integraci API. Existuje spousta z nich a každý z nich má svá pravidla integrace. Ale mějte na paměti, že očekáváte a Odezva kdykoli navážete spojení s API.

Způsob, jakým zadáváte požadavky prostřednictvím koncového bodu API, je obvykle založen na pravidlech definovaných poskytovatelem, ale to, co uděláte s odpovědí, kterou získáte, závisí na vašich preferencích. V podstatě jej můžete otočit, jak chcete, aby odpovídalo zkušenostem a rozhraní uživatelů vaší aplikace.

Před přístupem k rozhraní API někdy potřebujete také ověřovatele. Tito ověřovatelé obvykle přicházejí jako přístupové tokeny nebo klíče API. Jakmile tento token projde testem ověřování, API poté signalizuje svůj koncový bod k navázání spojení mezi vaší aplikací a serverem poskytovatele.

Jako spotřebitel API se nemusíte starat o tyto parametry, protože je zprostředkovatel API zpřístupňuje. Skvělé rozhraní API by mělo také uvádět, jak můžete v jeho dokumentaci přistupovat a používat jeho zdroje. Při pokusu o integraci na to tedy vždy dávejte pozor.

Zaokrouhlit to nahoru, volání API je o záhlaví, an koncový bod„ žádosta Odezva nebo tělo.

I když jsme vysvětlili, co je to koncový bod, pojďme dále rozebrat tyto další pojmy:

Záhlaví

Při připojování k API je obvykle nutné popsat dvě formy záhlaví: žádost a Odezva záhlaví.

The záhlaví požadavku je brána volání API. Popisuje přístup klienta k přístupu ke zdroji. Mohlo by to podrobně popsat věci, jako je přijatelný typ připojení, informace o proxy serveru a datový typ (JSON, XML nebo HTML), který chcete získat z API.

Jak jsme popsali dříve, v závislosti na typu rozhraní API, ke kterému se připojujete, možná budete muset zadat jedinečný ověřovací token také v záhlaví požadavku. Poskytovatel to obvykle dává.

The hlavička odpovědi, na druhé straně, je tvrzení o datech pocházejících ze serveru poskytovatele. Poskytuje vaší aplikaci informace o vlastnostech poskytovatele. V podstatě zajišťuje, že vaše aplikace udělí přístup k odpovědi pocházející z API.

Žádost o API

Žádost API obvykle obsahuje koncový bod v URL (Unique Resource Locator). Používá protokol HTTP (Hypertext Transfer Protocol) k vyhledání adresy prostředku, ke kterému se pokoušíte získat přístup pomocí rozhraní API. Nakonec požadavek API není úplný, pokud koncový bod do adresy URL nezahrnete.

Odpověď API

Odpověď je to, co API odešle zpět pokaždé, když obdrží požadavek z vaší aplikace. Může to být JSON, XML nebo HTML, v závislosti na typu dat nebo obsahu, který obdrží z hlavičky vašeho požadavku.

Jakmile dostanete odpověď z API, můžete považovat volání API za úspěšné.

Jak používat API: Praktické příklady

Nyní, když znáte základy API a co potřebujete k integraci jednoho. Podívejte se, jak se připojit a integrovat API pro fotbalové předpovědi RapidAPI pomocí Pythonu níže.

Je to jednoduché volání API, které vrací odpověď JSON. Můžete také napsat svůj kód do libovolný textový editora spusťte jej pomocí příkazového řádku.

Příbuzný: Jak spustit skript Pythonu

Věnujte však velkou pozornost koncovému bodu, obsahu záhlaví požadavku a záhlaví odpovědi:

požadavky na import
koncový bod = " https://football-prediction-api.p.rapidapi.com/api/v2/predictions"
queryparams = {"market": "classic", "iso_date": "2021-01-01", "federace": "UEFA"}
# Definujte záhlaví požadavku:
záhlaví = {
'x-rapidapi-key': "Sem vložte přístupový klíč",
'x-rapidapi-host': "football-prediction-api.p.rapidapi.com"
}
# Definujte záhlaví odpovědi:
response = requests.request ("GET", endpoint, headers = headers, params = queryparams)
# Získejte odpověď:
tisk (response.text)

Stále se uč: Jak používat IPStack API pro vyhledávání geolokace IP

Co takhle zjistit aktuální teplotu a vlhkost místa pomocí Weatherstack API s Pythonem? Zde je příklad níže:

požadavky na import
endpoint = ' http://api.weatherstack.com/current'
záhlaví = {
"access_key": "Sem vložte přístupový klíč",
"query": "California"
}
req = requests.get (koncový bod, záhlaví)
res = req.json ()
tisk (u "Aktuální teplota v% s je% d ℃"% 
(res ["umístění"] ["název"], res ["aktuální"] ["teplota"]))
tisk (u "Aktuální vlhkost v% s je% d ℃"% 
(res ["umístění"] ["název"], res ["aktuální"] ["vlhkost"]))

Typy rozhraní API, které můžete integrovat

Open-source API jsou zdarma a může je používat kdokoli. Interní rozhraní API jsou umístěna v organizaci a její prostředky mohou používat pouze aplikace patřící této organizaci.

Můžete se však také rozhodnout pro vyhrazené API zadáním partnerské smlouvy s poskytovatelem. Nebo můžete kombinovat několik API k řešení různých problémů.

Také tato API, s výjimkou open-source a interních API, mohou mít cenu, někdy v rozmezí od stovek do tisíců dolarů.

Zjednodušte vývoj aplikací pomocí API

Jak vidíte, že už nemusíte psát časově náročný kód. Pokud potřebujete, aby vaše aplikace prováděla složité operace, můžete ji vždy vyhledat a získat příslušné rozhraní API. Naštěstí jsou nyní dokonce snadno integrovatelné než staré konvenční. A pokud jste zvědaví a chcete vědět víc, existuje mnoho bezplatných API, které vám pomohou zašpinit si ruce.

Jak API fungují a jak je integrovat do vaší aplikace

Používání aplikačních programovacích rozhraní (API) je základní dovednost, kterou musí všichni programátoři zvládnout.

Přečtěte si další

O autorovi