Čo znamená API? Príklady použitia API

API je skratka pre „Application Programming Interface“. Aj keď to môže znieť čudne, ak ste v programovaní nováčikom, ľahko ich pochopíte, keď to rozoberiete. Používate ich dokonca každý deň pri práci s mobilným telefónom, počítačom alebo pri prehľadávaní internetu.

Softvér vrátane webových aplikácií, mobilných aplikácií a mnohých ďalších programov spája svet prostredníctvom internetu. Aby sme to však zefektívnili, musí medzi týmto softvérom existovať komunikačný kanál - práve tam prichádza API.

Tu vysvetlíme význam API a ako ich používať.

Čo je to API?

Viete, ako môžete okrem iného vidieť videá na streamovacích platformách ako Netflix a YouTube? Je to možné, pretože žiadosť odosielate cez rozhranie API.

Alebo ste si predstavili, ako ste schopní zaplatiť za tovar, ktorý kupujete v internetových obchodoch, ako sú Amazon a eBay? Je to tak aj preto, že medzi vašou bankou a nákupnými aplikáciami existuje komunikačný kanál známy ako API.

To znamená, že API je rozhranie so sadou pravidiel, ktoré umožňujú serveru vašej aplikácie komunikovať so serverom poskytovateľa riešenia, aby ste mohli využívať jeho zdroje. V podstate definuje vzájomnú komunikáciu aplikácií alebo softvéru.

V niektorých prípadoch však API umožňuje vzájomnú výmenu údajov. Príkladom je spojenie, ktoré existuje medzi vašimi bankovými aplikáciami a aplikáciami online obchodu.

API je ako posol. Na jednom konci sa pripája k serveru poskytovateľa a na druhom konci tiež zakotvuje server klienta. Potom zadá požiadavku klienta na zdroj údajov (server poskytovateľa) a vráti klientovi odpoveď. Klientom je tu prehliadač alebo vaša aplikácia.

Háčik však vašu aplikáciu pripája k API. To je koncový bod API. Veľa vecí sa však odohráva v zákulisí. Tieto vysvetlíme ďalej.

Ako vám API pomáhajú rýchlejšie vyvíjať aplikácie

API sú inteligentnejším nástrojom na vytváranie bezproblémových a robustných aplikácií. Bez nich by budovanie sofistikovaných aplikácií trvalo veky.

Predstavte si, že potrebujete svoju aplikáciu na vykonávanie zložitých operácií, ktorých vytvorenie si vyžaduje veľa času a úsilia. A potom sa niekto objaví s pripraveným programom, ktorý robí presne to, čo chcete, a možno aj lepšie.

Ako to však môžete prepojiť so svojou aplikáciou? Poskytovateľ, ktorý si to uvedomuje, vám môže dať trochu zabrať, potom vám povedal, že vytvoril rozhranie pripojenia (API), ktoré umožňuje bezproblémovú integráciu ich a vášho kódu.

Toto rozhranie (API) sa pripája k serveru, ktorý obsahuje ich kód. Potom vám poskytne spätné údaje z činnosti ich skriptu.

Samozrejme, nechcete sa nudiť celým ich zdrojovým skriptom. Okrem toho sa väčšina moderných rozhraní API teraz spolieha na štandardizovanú technológiu REST (Representational State Transfer). Vďaka tomu sú vysoko škálovateľné a ľahko sa integrujú, bez toho, aby ste sa museli obávať toho, čo sa odohráva v rámci vašej organizácie alebo stavu vašej odpovede alebo požiadavky, pretože sú vopred naformátované.

Tento článok nebude ďalej vysvetľovať REST API. Zatiaľ sa zamerajte na základné informácie.

Pripojiť váš kód k ich je lepší nápad, ako ich písať úplne od začiatku. Ak to však chcete urobiť, musíte svoj kód pripojiť pomocou API, ktoré poskytli. Ako to robis Tam prichádza na scénu koncový bod API.

Čo je koncový bod API?

Pre zjednodušenie poskytovatelia potom umiestnia adresu URL, aby bolo pripojenie k ich API bezproblémové. Takáto adresa URL je Koncový bod API. Vďaka tomu potom bude môcť vaša aplikácia získať prístup na svoj server prostredníctvom rozhrania API a priamo komunikovať so svojím skriptom.

Všetko, čo musíte urobiť, je teda chytiť koncový bod, vložiť ho do vášho kódu, zadávať s ním požiadavky, prispôsobiť odpovede a potom to funguje a je váš! Koncový bod API preto viaže vašu aplikáciu cez API na riešenie alebo zdroj údajov.

Nakoniec, veľa programov, ktoré ponúkajú API, je k dispozícii v rôznych programovacích jazykoch, takže nikto nebude vylúčený z toho, že z nich bude mať úžitok.

Takto sa dostanete ku kódu rýchlejšie a efektívnejšie s vedomím, že zodpovednosť za údržbu API nie je na vás, ale na poskytovateľoch údajov alebo riešení.

Koncový bod API je preto komunikačný hák, ktorý viaže API na server zdrojov na jednom okraji a spája ho so serverom prijímača na druhom konci.

To potom znamená, že nepotrebujete celý skript riešenia, ktoré chcete použiť. Váš kód s ním však nemôže nadviazať komunikáciu, ak sa nepripojí k svojmu koncovému bodu API.

Pravidlá integrácie API

Neexistuje tvrdé pravidlo pre integráciu API. Je ich veľa a každý z nich má svoje pravidlá integrácie. Majte však na pamäti, že čakáte a odpoveď vždy, keď nadviažete spojenie s API.

To, ako zadávate požiadavky prostredníctvom koncového bodu API, je zvyčajne založené na pravidlách definovaných poskytovateľom, ale to, čo urobíte s odpoveďou, ktorú dostanete, závisí od vašich preferencií. V zásade ho môžete ľubovoľne otáčať, aby vyhovoval zážitkom a rozhraniu používateľov vašej aplikácie.

Pred prístupom k rozhraniu API niekedy potrebujete aj autentifikátor. Takéto autentifikátory zvyčajne prichádzajú ako prístupové tokeny alebo kľúče API. Keď tento token prejde testom autentifikácie, API potom signalizuje svojmu koncovému bodu, aby nadviazal spojenie medzi vašou aplikáciou a serverom poskytovateľa.

Ako spotrebiteľ API si nemusíte robiť starosti s týmito parametrami, pretože ich poskytuje poskytovateľ API. Skvelé rozhranie API by malo vo svojej dokumentácii uvádzať aj to, ako máte prístup k jeho prostriedkom a ako ich môžete používať. Keď sa pokúšate integrovať jeden, vždy na to dávajte pozor.

Aby sme to zakončili, volanie API je predovšetkým o hlavičky, an koncový bod, žiadosťa odpoveď alebo telo.

Aj keď sme vysvetlili, čo je to koncový bod, poďme si ďalej rozobrať tieto ďalšie pojmy:

Hlavičky

Pri pripájaní k API musíte zvyčajne popísať dve formy hlavičiek: žiadosť a odpoveď hlavičky.

The hlavička požiadavky je bránou volania API. Opisuje prístup klienta k prístupu k prostriedku. Môže obsahovať podrobnosti ako prijateľný typ pripojenia, informácie o serveri proxy a dátový typ (JSON, XML alebo HTML), ktorý chcete získať z rozhrania API.

Ako sme už opísali, v závislosti od typu rozhrania API, ku ktorému sa pripájate, bude pravdepodobne potrebné poskytnúť jedinečný autentifikačný token aj v hlavičke požiadavky. Poskytovateľ to zvyčajne dáva.

The hlavička odpovede, na druhej strane, je tvrdenie údajov prichádzajúcich zo servera poskytovateľa. Poskytuje vašej aplikácii informácie o vlastnostiach poskytovateľa. V podstate to zaisťuje, že vaša aplikácia poskytuje prístup k odpovediam pochádzajúcim z API.

Žiadosť API

Požiadavka API zvyčajne obsahuje koncový bod v adrese URL (Unique Resource Locator). Používa protokol HTTP (Hypertext Transfer Protocol) na vyhľadanie adresy zdroja, ku ktorému sa pokúšate získať prístup pomocou rozhrania API. Žiadosť API nakoniec nie je úplná, ak do adresy URL nezadáte koncový bod.

Odozva API

Odpoveď je to, čo API pošle späť zakaždým, keď dostane požiadavku z vašej aplikácie. Môže to byť JSON, XML alebo HTML, v závislosti od typu údajov alebo obsahu, ktorý dostane z hlavičky požiadavky.

Keď dostanete odpoveď z API, potom môžete považovať vaše volanie API za úspešné.

Ako používať API: Praktické príklady

Teraz, keď už poznáte základné informácie o API a čo musíte integrovať. Zistite, ako sa dá pripojiť a integrovať API pre futbalové predpovede RapidAPI pomocou Pythonu nižšie.

Je to jednoduché volanie API, ktoré vracia odpoveď JSON. Môžete tiež napísať kód do ľubovoľný textový editora spustite ho z príkazového riadku.

Súvisiace: Ako spustiť Python Script

Venujte však osobitnú pozornosť koncovému bodu, obsahu hlavičiek požiadaviek a hlavičiek odpovedí:

požiadavky na import
koncový bod = " https://football-prediction-api.p.rapidapi.com/api/v2/predictions"
queryparams = {"market": "classic", "iso_date": "2021-01-01", "federácia": "UEFA"}
# Definujte hlavičku požiadavky:
hlavičky = {
'x-rapidapi-key': "Sem vložte prístupový kľúč",
'x-rapidapi-host': "football-prediction-api.p.rapidapi.com"
}
# Definujte hlavičku odpovede:
response = requests.request ("GET", endpoint, headers = headers, params = queryparams)
# Získať odpoveď:
print (response.text)

Pokračujte v učení: Ako používať IPStack API na vyhľadávanie geolokalizácie IP

Čo tak zistiť aktuálnu teplotu a vlhkosť miesta pomocou Weatherstack API s Pythonom? Tu je príklad nižšie:

požiadavky na import
koncový bod = ' http://api.weatherstack.com/current'
hlavičky = {
"access_key": "Sem vložte prístupový kľúč",
"query": "Kalifornia"
}
req = requests.get (koncový bod, hlavičky)
res = req.json ()
tlač (u "Aktuálna teplota v% s je% d ℃"% 
(res ["location"] ["name"], res ["current"] ["temperature"]))
tlač (u "Aktuálna vlhkosť v% s je% d ℃"% 
(res ["location"] ["name"], res ["current"] ["vlhkost"]))

Typy rozhraní API, ktoré môžete integrovať

Open-source API sú zadarmo a môže ich používať ktokoľvek. Interné rozhrania API sa nachádzajú v organizácii a jej zdroje môžu používať iba aplikácie patriace k tejto organizácii.

Môžete sa však tiež rozhodnúť pre vyhradené rozhranie API zadaním partnerskej dohody s poskytovateľom. Alebo môžete kombinovať niekoľko rozhraní API a vyriešiť tak rôzne problémy.

Aj tieto API, s výnimkou open-source a interných API, môžu mať cenu, ktorá sa niekedy pohybuje od stoviek do tisícov dolárov.

Zjednodušte vývoj aplikácií pomocou rozhraní API

Ako vidíte, už nemusíte písať časovo náročný kód. Ak potrebujete, aby vaša aplikácia vykonávala zložité operácie, môžete ju kedykoľvek vyhľadať a získať príslušné API. Našťastie sa teraz dajú dokonca ľahko integrovať ako staré bežné. A ak ste zvedaví a chcete vedieť viac, existuje veľa bezplatných rozhraní API, ktoré vám môžu pomôcť zašpiniť si ruky.

Ako fungujú rozhrania API a ako ich integrovať do vašej aplikácie

Používanie aplikačných programovacích rozhraní (API) je základnou zručnosťou všetkých programátorov, aby si ich osvojili.

Prečítajte si Ďalej

O autorovi