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

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

API je zkratka pro „Application Programming Interface“. A i když to může znít divně, pokud jste v programování nováčci, jsou snadno pochopitelné, jakmile to rozeberete. Dokonce je používáte denně při ovládání mobilního telefonu, počítače nebo při procházení internetu.





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





Zde vysvětlíme význam API a jejich použití.





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ží zakoupené v internetových obchodech, jako je 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í, abyste mohli používat jeho prostředky. V podstatě definuje, jak spolu aplikace nebo software 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í klientovi odpověď. Klientem je zde prohlížeč nebo vaše aplikace.

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





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

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

Představte si, že vaši aplikaci potřebujete k provádění složitých operací, jejichž sestavení zabere spoustu času a úsilí. A pak se někdo objeví s připraveným programem, který dělá přesně to, co chcete, a možná i lepší.

jak sledovat provoz v domácí síti

Jak to ale můžete propojit s vaší aplikací? Poskytovatel, který si uvědomil, že vám to může dát trochu zabrat, vám pak řekl, že vytvořil rozhraní pro připojení (API), díky kterému se jejich kód a váš integrují hladce.

Toto rozhraní (API) se připojí k serveru, který obsahuje jejich kód. Poté vás přivede zpět k relevantním datům z akce jejich skriptu.

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

Tento článek nebude dále vysvětlovat REST API. Soustřeďte se prozatím na základy.

Zapojit svůj kód do jejich je lepší nápad, než ho psát od nuly. Chcete -li to provést, musíte však kód spojit s rozhraním API, které poskytli. Jak to děláš? Právě tam přichází na scénu koncový bod API.

Co je koncový bod API?

Aby se věci zjednodušily, poskytovatelé poté vložili adresu URL, aby bylo připojení k jejich API bezproblémové. Taková adresa URL je Koncový bod API . S ním pak vaše aplikace může přistupovat k jejich serveru prostřednictvím API a komunikovat přímo se svým skriptem.

Vše, co musíte udělat, je chytit koncový bod, vložit jej do kódu, odesílat s ním žádosti, přizpůsobovat 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 jejich využívání.

Díky tomu se ke kódu dostanete rychleji a efektivněji s vědomím, že údržba 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 jej 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

Pro integraci API neexistuje žádné tvrdé pravidlo. Je jich tam spousta a každý z nich má svá integrační pravidla. Ale mějte na paměti, že očekáváte a Odezva kdykoli navážete připojení pomocí API.

Jak zadáváte požadavky prostřednictvím koncového bodu API, je obvykle založeno 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 zásadě jej můžete zkroutit, jak chcete, aby odpovídal zkušenostem a rozhraní uživatelů vaší aplikace.

Někdy k přístupu k API potřebujete také autentizátor. Takoví autentizátoři obvykle přicházejí jako přístupové tokeny nebo klíče API. Jakmile tento token projde ověřovacím testem, API poté signalizuje svůj koncový bod k navázání spojení mezi vaší aplikací a serverem poskytovatele.

Jako spotřebitel API si s těmito parametry nemusíte dělat starosti, protože je poskytuje poskytovatel API. Skvělé API by také mělo ve své dokumentaci uvádět, jak můžete přistupovat k jeho prostředkům a používat je. Při pokusu o jejich integraci na to tedy vždy dávejte pozor.

Abychom to zaokrouhlili, volání API je o záhlaví , an koncový bod , žádost a Odezva nebo tělo .

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

Záhlaví

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

The hlavička požadavku je bránou volání API. Popisuje klientův přístup k přístupu ke zdroji. Může obsahovat podrobnosti jako přijatelný typ připojení, informace o serveru proxy a datový typ (JSON, XML nebo HTML), který chcete získat z rozhraní API.

Jak jsme popsali dříve, v závislosti na typu rozhraní API, ke kterému se připojujete, možná budete muset v záhlaví požadavku poskytnout také jedinečný ověřovací token. 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 charakteristikách poskytovatele. V podstatě zajišťuje, že vaše aplikace uděluje přístup k odpovědi pocházející z API.

Požadavek API

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

balíček Amazon říká, že doručeno, ale nikdy nepřišlo

Odpověď API

Odpověď je to, co API odešle zpět pokaždé, když obdrží požadavek od 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 jejich integraci. Podívejte se, jak se připojit a integrovat rozhraní API pro předpověď fotbalu RapidAPI pomocí Pythonu níže.

Je to jednoduché volání API, které vrací odpověď JSON. Kód můžete také napsat v libovolném textovém editoru a spustit jej pomocí příkazového řádku.

Příbuzný: Jak spustit skript Python

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

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)

Keep Learning: How to Use the IPStack API for IP Geolocation Lookss

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

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, která můžete integrovat

Open-source API jsou zdarma a používat je může kdokoli. Interní rozhraní API se nacházejí 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 rozhraní API a řešit různé problémy.

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

Zjednodušte vývoj aplikací pomocí rozhraní API

Jak vidíte, 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 kdykoli 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íce, existuje mnoho bezplatných rozhraní API, která vám pomohou ušpinit si ruce.

Podíl Podíl tweet E-mailem Jak fungují rozhraní API a jak je integrovat do vaší aplikace

Používání rozhraní pro programování aplikací (API) je základní dovedností, kterou všichni programátoři zvládají.

Číst dále
Související témata
  • Programování
  • Programování
  • OHEŇ
  • Žargon
  • Tipy pro kódování
O autorovi Idisou Omisola(94 publikovaných článků)

Idowu je zapálený pro cokoli chytrého a produktivního. Ve svém volném čase si hraje s kódováním a když se nudí, přepne na šachovnici, ale také se rád jednou za čas odpoutá od rutiny. Jeho vášeň ukazovat lidem cestu kolem moderních technologií ho motivuje psát více.

Více od Idowu Omisola

Přihlaste se k odběru našeho zpravodaje

Připojte se k našemu zpravodaji a získejte technické tipy, recenze, bezplatné elektronické knihy a exkluzivní nabídky!

Kliknutím sem se přihlásíte k odběru