API-ji povezuju aplikacije kroz jasne protokole i arhitekture. API arhitektura je okvir pravila za kreiranje softverskih sučelja. Pravila određuju kako korisnicima pružiti funkcionalnost poslužitelja. Vrsta arhitekture određuje pravila i strukture koje upravljaju API-jem.
Postoji mnogo različitih vrsta API arhitekture, od REST do RPC. Učenje o njihovoj strukturi i sastavu pomoći će vam da odaberete jedan za svoju aplikaciju.
1. ODMOR
REST API-ji su moderni i najpopularnija su API arhitektura koju programeri koriste. ODMOR (representational state transfer) je arhitektura koja se koristi za dizajn aplikacija klijent-poslužitelj. To nije protokol ili standard, pa ga možete implementirati na razne načine. Ovaj aspekt povećava vašu fleksibilnost kao programera.
REST omogućuje pristup traženim podacima pohranjenim u bazi podataka. Osnovne CRUD funkcije možete izvoditi s REST API-jem. Kada klijenti traže sadržaj putem RESTful API-ja, moraju koristiti ispravna zaglavlja i parametre. Zaglavlja sadrže korisne metapodatke za identifikaciju resursa, poput statusnih kodova i autorizacije.
Informacije koje se prenose putem HTTP-a mogu biti u JSON, HTML, XML ili običnom tekstu. JSON je najčešće korišteni format datoteke za REST API-je. JSON ne ovisi o jeziku i čitljiv je ljudima.
2. SAPUN
Jednostavan protokol za pristup objektu (SOAP) službeni je API protokol. World Wide Web Consortium (W3C) održava SOAP protokol, koji je jedna od najranijih API arhitektura. Njegov dizajn olakšava komunikaciju između aplikacija izgrađenih na različitim jezicima i platformama.
SOAP format opisuje API koristeći jezik opisa web usluge (WSDL). Napisan je u ekstenzivnom označnom jeziku (XML). Format nameće ugrađene standarde usklađenosti koji povećavaju sigurnost, dosljednost, izolaciju i trajnost. Ova svojstva osiguravaju pouzdane transakcije baze podataka čineći SOAP boljim za razvoj poduzeća.
Kada korisnik zatraži sadržaj putem SOAP API-ja, on prolazi kroz standardne protokole sloja. Odgovor je u XML formatu, koji ljudi i strojevi mogu čitati. Poput REST API-ja, SOAP API-ji ne spremaju/pohranjuju podatke u predmemoriju. Ako vam podaci zatrebaju kasnije, morate napraviti još jedan zahtjev.
SOAP podržava razmjenu podataka bez statusa i statusa.
3. GraphQL
GraphQL je upitni jezik za API. To je runtime na strani poslužitelja koji izvršava upite na temelju definiranog skupa podataka. GraphQL ima specifične slučajeve upotrebe. Njegova arhitektura omogućuje vam deklariranje specifičnih informacija koje su vam potrebne.
Za razliku od REST arhitekture, gdje HTTP obrađuje zahtjeve i odgovore klijenta, GraphQL traži podatke s upitima. Usluga GraphQL definira tipove i polja tih tipova, zatim pruža funkcije za svako polje i tip.
Usluga prima GraphQL upiti potvrditi i izvršiti. Prvo provjerava upit kako bi se osiguralo da se odnosi na definirane tipove i definirana polja. Zatim pokreće povezane funkcije kako bi proizveo željeni rezultat.
GraphQL je izvrstan za određene slučajeve upotrebe kao što je dohvaćanje podataka iz više izvora. Također možete kontrolirati dohvaćanje podataka i regulirati propusnost za manje uređaje.
4. Apaš Kafka
Apaš Kafka je distribuirana platforma koja podržava streaming događaja. Streaming događaja je proces hvatanja podataka iz izvora u stvarnom vremenu. Izvori mogu biti baze podataka, poslužitelji ili softverske aplikacije. Sustav Kafka sastoji se od poslužitelja i klijenata. Komunikacija se odvija preko TCP mrežnog protokola.
Sustav možete postaviti na hardver, virtualne strojeve i spremnike. To možete učiniti on-premise i u oblaku. Apache Kafka sustav snima podatke, obrađuje ih i reagira na njih u stvarnom vremenu. Također može usmjeriti podatke na željeno odredište u stvarnom vremenu. Kafka bilježi i pohranjuje podatke u sustavu koje kasnije možete dohvatiti za korištenje.
Kafka podržava kontinuirani protok i integraciju podataka. To osigurava da su informacije na pravom mjestu, u pravo vrijeme. Strujanje događaja može se primijeniti na mnoge slučajeve upotrebe koji zahtijevaju strujanje podataka uživo. To uključuje financijske institucije, zdravstvenu skrb, vladu, transportnu industriju i tvrtke za računalni softver.
5. AsyncAPI
AsyncAPI je inicijativa otvorenog koda koja pomaže u izgradnji i održavanju arhitektura vođenih događajima. Njegove specifikacije imaju mnogo toga zajedničkog sa specifikacijama OpenAPI-ja. AsyncAPI je u biti adaptacija i poboljšanje OpenAPI specifikacija, s nekoliko razlika.
Arhitektura AsyncAPI spaja mješavinu REST API-ja i API-ja vođenih događajima. Njegove sheme za rukovanje zahtjevima i odgovorima su slično API-jima događaja. AsyncAPI pruža specifikacije za opisivanje i dokumentiranje asinkronih aplikacija u strojno čitljivom obliku format. Također nudi alate poput generatora koda kako bi korisnicima olakšali njihovu implementaciju.
AsyncAPI poboljšava trenutno stanje arhitekture vođene događajima (EDA). Cilj je olakšati rad s EDA-ima kao što je to slučaj s REST API-jima. Inicijativa AsyncAPI pruža dokumentaciju i kod koji podržavaju upravljanje događajima. Većina procesa koji se koriste u REST API-jima odnosi se na API-je vođene događajima/asinkrone API-je.
Korištenje AsyncAPI specifikacije za dokumentiranje sustava vođenih događajima je od vitalnog značaja. Upravlja i održava dosljednost i učinkovitost među timovima koji rade na projektima vođenim događajima.
6. Poziv udaljene procedure (RPC)
RPC je softverski komunikacijski protokol koji omogućuje komunikaciju između različitih programa na mreži. Na primjer, program može zatražiti informacije od drugog računala na mreži. Ne mora se pridržavati mrežnih protokola. Možete koristiti RPC za pozivanje procesa na udaljenim sustavima baš kao i na lokalnom sustavu.
RPC radi po modelu klijent-poslužitelj. Klijentski program zahtijeva, a poslužiteljski program odgovara uslugom. RPC-ovi rade sinkronizirano. Kada program pošalje zahtjev, on ostaje suspendiran dok ne dobije odgovor od poslužitelja.
RPC-ovi su najbolji za distribuirane sustave. Najbolji su za sustave koji se temelje na naredbama i imaju male nosivosti koje povećavaju performanse.
Kako odabrati pravu API arhitekturu
Prava API arhitektura ovisi o vašem slučaju upotrebe. Arhitektura određuje metodologiju razvoja API-ja i način na koji će se on izvoditi. Arhitektonski dizajn API-ja definira njegove komponente i interakcije.
Donesite arhitektonske odluke prije dizajniranja i razvoja API-ja. Odredite tehničke zahtjeve API-ja, razinu, upravljanje životnim ciklusom i sigurnost. Dizajni API arhitekture sadrže strukturne slojeve. Slojevi vode razvoj i osiguravaju da stvoreni API služi svojoj namjeni.
