Zkratka proApplication Programming Interface/ˌeɪ.piːˈaɪ/ej-pí-ajTakéaplikační rozhraní, programové rozhraníZákladní
Definice
API je smluvené rozhraní, přes které spolu dva programy komunikují, aniž by jeden musel znát vnitřní fungování druhého. Definuje, jaké operace lze volat, jaká data se posílají a co se vrátí zpět.
Jak API funguje
API je v podstatě kontrakt. Jedna strana slíbí, že na určitou adresu a v určitém formátu přijme požadavek a odpoví předvídatelným způsobem. Druhá strana se na ten slib spolehne a nemusí řešit, jestli za ním běží PHP, Rust nebo tabulka v Excelu.
Díky tomu se dá systém rozdělit na části, které vyvíjejí různé týmy různým tempem. Dokud kontrakt platí, můžete vnitřek kterékoli části přepsat od nuly a nikdo si toho nevšimne.
Kdy API potřebujete
Vždycky, když má váš systém mluvit s něčím, co neovládáte: platební branou, skladem, fakturačním systémem, mobilní aplikací. A také tehdy, když chcete, aby vaše data mohl někdo další používat bez toho, aby se díval do vaší databáze.
Příklady z praxe
Platební brána
E-shop pošle na API platební brány částku a identifikátor objednávky. Brána vrátí adresu platební stránky. E-shop vůbec neví, jak brána komunikuje s bankou, a ani to vědět nepotřebuje.
Časté omyly
- MýtusAPI a REST jsou to samé.
- Ve skutečnostiREST je jeden ze způsobů, jak API postavit. API může být stejně dobře GraphQL, gRPC, SOAP nebo knihovní rozhraní, které se volá přímo v kódu bez jakékoli sítě.
Časté dotazy
- Jaký je rozdíl mezi API a webovou službou?
- Webová služba je API, které je dostupné přes síť, typicky přes HTTP. Každá webová služba je tedy API, ale ne každé API je webová služba: rozhraní knihovny, kterou si přilinkujete do programu, je také API, jen se nevolá po síti.
Zdroje
- API(otevře se v novém okně)
Související pojmy
