Intro
Le cúpla cad a tharlaíonn ar dheasc nó gléas, is féidir aon rud a cheannach, a dhíol nó a fhoilsiú, am ar bith. Go beacht conas a tharlaíonn sé? Conas a dhéanann eolas a fháil ó anseo go dtí ann? Is é an laoch neamhaitheanta ná an API.
Cad is API ann?
Seasann API do COMHDHÉANAMH CLÁRÚ IARRATAIS. Cuireann API comhpháirt bogearraí in iúl, a cuid oibríochtaí, ionchuir, aschuir agus cineálacha bunúsacha. Ach conas a mhíníonn tú an API i mBéarla simplí? Feidhmíonn an API mar theachtaire a aistríonn d’iarratas ó fheidhmchlár agus a sheachadann an freagra ar ais chugat.
1 Sampla: Agus tú ag cuardach eitiltí ar líne. Idirghníomhaíonn tú le suíomh Gréasáin na haerlíne. Sonraíonn an suíomh Gréasáin na suíocháin agus costas na heitilte ar an dáta agus an t-am áirithe sin. Roghnaíonn tú do bhéile nó do shuíocháin, do bhagáiste nó d’iarratais peataí.
Ach, mura bhfuil suíomh Gréasáin díreach na haerlíne á úsáid agat nó má tá gníomhaire taistil ar líne in úsáid agat a chomhcheanglaíonn sonraí ó go leor aerlínte. Chun an fhaisnéis a fháil, idirghníomhaíonn feidhmchlár le API na haerlíne. Is é an API an comhéadan a thógann sonraí ó shuíomh Gréasáin an ghníomhaire taistil chuig córas na haerlíne.
Glacann sé freisin le freagairt na haerlíne agus seachadann ar ais díreach. Éascaíonn sé seo an idirghníomhaíocht idir an tseirbhís taistil, agus na córais aerlíne - chun an eitilt a chur in áirithe. Tá leabharlann le haghaidh gnáthaimh, struchtúir sonraí, aicmí oibiachtaí agus athróga i gceist le API. Mar shampla, gallúnach agus seirbhísí REST.
2 Sampla: Cuireann Best Buy clár speisialta praghsála Margadh an Lae ar fáil trína shuíomh Gréasáin. Tá na sonraí céanna seo ina bhfeidhmchlár soghluaiste. Ní bhíonn imní ar an aip faoin gcóras praghsála inmheánach - is féidir leis an API Margadh an Lae a ghlaoch agus fiafraí de, cad é an praghsáil speisialta? Freagraíonn Best Buy leis an bhfaisnéis iarrtha i bhformáid chaighdeánach a thaispeánann an aip don úsáideoir deiridh.
Sampla3: Tá APIanna do na meáin shóisialta ríthábhachtach. Is féidir le húsáideoirí rochtain a fháil ar ábhar agus líon na gcuntas agus na bhfocal faire a choinníonn siad súil orthu a choinneáil íseal, ionas gur féidir leo rudaí a choinneáil simplí.
- Twitter API: Déan idirghníomhú le formhór na bhfeidhmeanna Twitter
- Facebook API: Le haghaidh íocaíochtaí, sonraí úsáideora, agus logáil isteach
- Instagram API: Clibeanna úsáideoirí, féach ar ghrianghraif threochta
Cad mar gheall ar REST & SOAP APIs?
SOAP agus REST úsáid a bhaint as seirbhís íditheach API, ar a dtugtar Web API. Níl seirbhís gréasáin ag brath ar aon eolas roimh ré ar fhaisnéis. Is prótacal seirbhíse gréasáin é SOAP atá neamhspleách ar ardán. Is prótacal teachtaireachtaí XML-bhunaithe é SOAP. Murab ionann agus seirbhís gréasáin SOAP, úsáideann seirbhís Restful ailtireacht REST, a tógadh le haghaidh cumarsáide pointe go pointe.
SOAP seirbhís Gréasáin
- GALLÚNACH Seoltóir – teachtaireacht a chruthú agus a tharchur.
- Glacadóir GALLÚNACH – faigheann agus próiseálann an teachtaireacht.
- Idirghabhálaí GALLÚNACH - faigheann sé agus próiseálann sé bloic ceanntásca.
Seirbhís Gréasáin RESTful
Baineann Aistriú Stáit Ionadaíoch (REST) leis an gcaidreamh idir an cliant agus an freastalaí agus an chaoi a bpróiseálann an stát. Ailtireacht scíthe, soláthraíonn Freastalaí REST rochtain acmhainne don chliant. Láimhseálann Rest an léamh agus na hacmhainní a mhodhnú nó a scríobh. Sainaithníonn Aitheantóir Aonfhoirmeach (URI) acmhainní chun doiciméad a chuimsiú. Gabhfaidh sé seo an stát acmhainní.
Tá REST níos éadroime ná ailtireacht gallúnach. Parsálann sé JSON, teanga atá inléite ag an duine a chuireann ar chumas sonraí a chomhroinnt agus atá níos éasca le húsáid, in ionad XML a úsáideann ailtireacht SOAP.
Tá roinnt prionsabal ann maidir le Seirbhís Gréasáin Restful a dhearadh, is iad sin:
- Seoltacht – Ba cheart go mbeadh URL amháin ar a laghad ag gach acmhainn.
- Easpa stát – Is seirbhís gan stát í seirbhís Restful. Tá iarratas neamhspleách ar aon iarratais a rinne an tseirbhís roimhe seo. Is prótacal gan stát é HTTP trí dhearadh.
- Inachaithe - Sonraí atá marcáilte mar stórtha in-chaisce sa chóras agus athúsáidfear iad sa todhchaí. Mar fhreagra ar an iarratas céanna in ionad a tháirgeadh na torthaí céanna. Cumasaíonn srianta taisce sonraí freagartha a mharcáil mar thaisce nó neamh-inchúlghairthe.
- Comhéadan aonfhoirmeach – Ceadaíonn sé comhéadan coiteann agus caighdeánaithe a úsáid le haghaidh rochtana. Úsáid a bhaint as bailiúchán sainithe modhanna HTTP. Cinntíonn cloí leis na coincheapa seo, tá cur i bhfeidhm REST éadrom.
Buntáistí REST
- Úsáidtear formáid níos simplí le haghaidh teachtaireachtaí
- Tairgeann éifeachtúlacht fhadtéarmach níos láidre
- Tacaíonn sé le cumarsáid gan stát
- Bain úsáid as caighdeáin HTTP agus gramadach
- Tá sonraí ar fáil mar acmhainn
Míbhuntáistí REST
- Teipeann ar chaighdeáin na seirbhíse Gréasáin mar Idirbhearta Slándála etc.
- Níl iarratais REST inscálaithe
Comparáid REST vs Gallúnach
Difríochtaí idir seirbhísí gréasáin GALLÚNACH agus REST.
Seirbhís Ghréasáin SOAP | Seirbhís Gréasáin Rest |
Éilíonn pálasta ionchuir trom i gcomparáid le REST. | Tá REST éadrom mar úsáideann sé URI le haghaidh foirmeacha sonraí. |
Is minic go mbíonn athrú suntasach ar chód ar thaobh an chliaint mar thoradh ar athrú ar sheirbhísí gallúnach. | Ní chuireann athrú ar sheirbhísí i soláthar gréasáin REST isteach ar chód an chliaint. |
Is cineál XML é an cineál tuairisceáin i gcónaí. | Soláthraíonn sé solúbthacht maidir le foirm na sonraí a chuirtear ar ais. |
Prótacal teachtaireachta bunaithe ar XML | Prótacal ailtireachta |
Éilíonn leabharlann gallúnach ar deireadh an chliaint. | Níl gá le tacaíocht leabharlainne a úsáidtear go hiondúil thar HTTP. |
Tacaíonn WS-Slándáil agus SSL. | Tacaíonn SSL agus HTTPS. |
Sainmhíníonn gallúnach a shlándáil féin. | Faigheann seirbhísí gréasáin RESTful bearta slándála ón mbun-iompar. |
Cineálacha Beartais Eisiúna API
Is iad na polasaithe eisiúna le haghaidh API:
Beartais um scaoileadh príobháideach:
Níl an API ar fáil ach le haghaidh úsáid inmheánach chuideachta.
Polasaithe scaoilte comhpháirtíochta:
Níl an API ar fáil ach do chomhpháirtithe gnó ar leith. Is féidir leis na cuideachtaí cáilíocht an API a rialú mar gheall ar an rialú ar cé atá in ann rochtain a fháil air.
Beartais um scaoileadh poiblí:
Tá an API le húsáid ag an bpobal. Tá infhaighteacht na mbeartas scaoilte ar fáil don phobal. Sampla: Microsoft Windows API agus Apple's Cocoa.
Conclúid
Tá APIanna i láthair i ngach áit, cibé an bhfuil tú ag cur eitilt in áirithe nó ag plé le feidhmchláir meán sóisialta. Tá API SOAP bunaithe ar chumarsáid XML, tá sé difriúil ó REST API sa mhéid is nach dteastaíonn aon chumraíocht speisialta uaidh.
Ba cheart do sheirbhísí Gréasáin Rest a dhearadh cloí le coincheapa áirithe, lena n-áirítear seoltacht, gan stát, inchleachtaitheacht, agus comhéadan caighdeánach. Féadfar rialacha maidir le heisiúint API a roinnt i dtrí chatagóir: APIs príobháideacha, APIanna comhpháirtíochta, agus APInna poiblí.
Go raibh maith agat as an alt seo a léamh. Amharc ar ár n-alt ar Threoir maidir le Slándáil API 2022.
