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

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

API je skratka pre „Application Programming Interface“. A aj keď to môže znieť divne, ak ste v programovaní nový, sú ľahko zrozumiteľné, keď ho rozložíte. Používate ich dokonca denne pri obsluhe mobilného telefónu, počítača alebo pri prehliadaní internetu.





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





Tu vysvetlíme význam rozhraní API a spôsob ich použitia.





Č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 odosielate žiadosť prostredníctvom rozhrania API.

Alebo ste si predstavili, ako ste schopní zaplatiť za tovar, ktorý si kúpite v internetových obchodoch, ako sú Amazon a eBay? Je to 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šení, aby ste mohli používať jeho zdroje. V zásade definuje, ako spolu aplikácie alebo softvér komunikujú.

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ž ukotví server klienta. Potom predloží 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 pripája vašu aplikáciu k API. To je koncový bod API. V zákulisí sa však odohráva veľa vecí. Tieto vysvetlíme ďalej.





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

Rozhrania 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 svoju aplikáciu potrebujete na vykonávanie komplexných operácií, ktorých výroba vyžaduje veľa času a úsilia. A potom sa niekto objaví s hotovým programom, ktorý robí presne to, čo chcete, a možno aj lepšie.

ako presúvať súbory medzi jednotkami Google

Ako to však môžete prepojiť s vašou aplikáciou? Poskytovateľ, ktorý si uvedomil, že vám to môže dať trochu zabrať, vám potom povedal, že vytvoril rozhranie rozhrania (API), vďaka ktorému sa ich kód a váš bez problémov integrujú.

Toto rozhranie (API) sa pripája k serveru obsahujúcemu ich kód. Potom vás vráti späť relevantné údaje z akcie 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 integrovateľné bez toho, aby ste sa museli starať o to, čo sa deje alebo o stav vašej odpovede alebo požiadavky, pretože sú vopred naformátované.

Tento článok nebude ďalej vysvetľovať REST API. Teraz sa zamerajte na základy.

Zapojiť kód do ich kódu je lepší nápad, ako ho písať od začiatku. Na to však musíte spojiť svoj kód s rozhraním API, ktoré poskytli. Ako to robíte? Tu prichádza na scénu koncový bod API.

Čo je to koncový bod rozhrania API?

Aby to zjednodušili, poskytovatelia potom zadali adresu URL, aby bolo pripojenie k ich rozhraniu API bezproblémové. Takáto adresa URL je Koncový bod API . Vďaka tomu môže vaša aplikácia potom pristupovať na svoj server prostredníctvom rozhrania API a komunikovať priamo so svojim skriptom.

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

Nakoniec mnohé programy, ktoré ponúkajú rozhrania API, sú k dispozícii v rôznych programovacích jazykoch, takže nikto z nich nebude vylúčený.

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

Koncový bod API je preto komunikačný háčik, ktorý viaže API na server zdrojov na jednom okraji a spája ho so serverom príjemcu 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

Na integráciu rozhrania API neexistujú žiadne pevné pravidlá. Existuje ich veľa a každý z nich má svoje integračné pravidlá. Myslite však na to, že očakávate a odpoveď vždy, keď nadviažete spojenie s API.

Spôsob odosielania žiadostí 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ú získate, závisí od vašich preferencií. V zásade ho môžete prekrútiť podľa vlastného uváženia tak, aby zodpovedal skúsenostiam a rozhraniu používateľov vašej aplikácie.

Niekedy pred prístupom k rozhraniu API potrebujete aj autentifikátor. Také autentifikátory sa zvyčajne dodávajú ako prístupové tokeny alebo kľúče API. Akonáhle tento token prejde testom autentifikácie, API potom signalizuje svojmu koncovému bodu, aby nadviazalo spojenie medzi vašou aplikáciou a serverom poskytovateľa.

Ako spotrebiteľ rozhrania API si s týmito parametrami nemusíte robiť starosti, pretože ich poskytuje poskytovateľ rozhrania API. Skvelé API by malo vo svojej dokumentácii tiež uvádzať, ako môžete pristupovať k jeho zdrojom a používať ich. Na to teda pri pokuse o integráciu vždy dávajte pozor.

Aby sme to zhrnuli, volanie rozhrania API je o hlavičky , an koncový bod , žiadosť a odpoveď alebo telo .

Aj keď sme vysvetlili, čo je koncový bod, rozoberme si tieto ďalšie pojmy ďalej:

Hlavičky

Pri pripájaní k rozhraniu API je zvyčajne potrebné 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 zdroju. Môže obsahovať podrobnosti o prijateľnom type pripojenia, informáciách o serveri proxy a dátovom type (JSON, XML alebo HTML), ktoré chcete získať z rozhrania API.

Ako sme už popísali, v závislosti od typu rozhrania API, ku ktorému sa pripájate, budete možno musieť poskytnúť jedinečný autentifikačný token aj v hlavičke žiadosti. Poskytovateľ to zvyčajne dáva.

The hlavička odpovede , na druhej strane je tvrdenie údajov pochádzajúcich zo servera poskytovateľa. Poskytuje vašej aplikácii informácie o charakteristikách poskytovateľa. V zásade zaisťuje, že vaša aplikácia udeľuje prístup k odpovedi pochádzajúcej z rozhrania API.

Žiadosť API

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

všetky trofeje na snapchate

Odpoveď API

Odpoveď je to, čo rozhranie API odošle späť zakaždým, keď dostane žiadosť od 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 vašej požiadavky.

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

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

Teraz, keď poznáte základy API a čo potrebujete na ich integráciu. Pozrite sa na to, ako sa pripojiť a integrovať rozhranie API predpovedí futbalu RapidAPI pomocou nižšie uvedeného jazyka Python.

Je to jednoduché volanie rozhrania API, ktoré vracia odpoveď JSON. Kód môžete tiež napísať v ľubovoľnom textovom editore a spustiť ho pomocou príkazového riadka.

Súvisiace: Ako spustiť skript Python

Dávajte však veľký pozor na koncový bod, obsah hlavičiek žiadostí a hlavičiek odpovedí:

import requests
endpoint = 'https://football-prediction-api.p.rapidapi.com/api/v2/predictions'
queryparams = {'market':'classic','iso_date':'2021-01-01','federation':'UEFA'}
#Define the request header:
headers = {
'x-rapidapi-key': 'Paste your access key here',
'x-rapidapi-host': 'football-prediction-api.p.rapidapi.com'
}
#Define the response header:
response = requests.request('GET', endpoint, headers=headers, params=queryparams)
#Get the response:
print(response.text)

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

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

import requests
endpoint = 'http://api.weatherstack.com/current'
headers = {
'access_key': 'Paste your access key here',
'query': 'California'
}
req = requests.get(endpoint, headers)
res = req.json()
print(u'Current temperature in %s is %d℃' %
(res['location']['name'], res['current']['temperature']))
print(u'Current humidity in %s is %d℃' %
(res['location']['name'], res['current']['humidity']))

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

Open-source API sú bezplatné 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 rozhodnúť aj pre vyhradené rozhranie API uzatvorením partnerskej zmluvy s poskytovateľom. Alebo môžete kombinovať niekoľko rozhraní API na riešenie rôznych problémov.

Tiež tieto API, s výnimkou open-source a interných API, môžu mať svoju cenu, niekedy sa pohybuje od stoviek do tisíc 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 komplexné 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é konvenčné. A ak ste zvedaví a chcete vedieť viac, existuje mnoho bezplatných rozhraní API, ktoré vám pomôžu zašpiniť si ruky.

zdieľam zdieľam Tweet E -mail Ako fungujú rozhrania API a ako ich integrovať do aplikácie

Používanie rozhraní API (Application Programming Interface) je základnou zručnosťou, ktorú si musia všetci programátori osvojiť.

Čítajte ďalej
Súvisiace témy
  • Programovanie
  • Programovanie
  • POŽIAR
  • Žargón
  • Tipy na kódovanie
O autorovi Idisou Omisola(94 publikovaných článkov)

Idowu je zanietený pre čokoľvek, čo sa týka inteligentných technológií a produktivity. Vo svojom voľnom čase sa hrá s kódovaním a keď sa nudí, prejde na šachovnicu, ale tiež rád, keď sa raz za čas odtrhne od rutiny. Jeho vášeň ukazovať ľuďom cestu okolo moderných technológií ho motivuje písať viac.

Viac od Idowu Omisola

prihlásiť sa ku odberu noviniek

Pripojte sa k nášmu bulletinu a získajte technické tipy, recenzie, bezplatné elektronické knihy a exkluzívne ponuky!

Kliknutím sem sa prihlásite na odber