REST API - seirbhís gréasáin áisiúil a chruthú

Sa bhliain 2000, cruthaíodh caighdeán nua le haghaidh idirghníomhaíochta idir cliaint agus freastalaithe i réimse dhearadh ailtireachta comhéadain clár. Tugadh REST air. Ba é Roy Fielding, duine de fhorbróirí phrótacal HTTP, príomhthionscnóir an choincheapa seo. Sa lá atá inniu ann, tá tóir ag méadú ar REST API le haghaidh malartú sonraí, rud a sholáthraíonn idirghníomhaíocht éifeachtach idir gach cineál feidhmchlár.

Is sraith prionsabal agus rialacha é API RESTful a ligeann duit idirghníomhaíocht idir cliant agus freastalaí a eagrú. Ligeann sé seo d’fhorbróirí feidhmchláir ghréasáin atá inathraithe agus inscálaithe go héasca a chruthú. Is é príomhsmaoineamh REST ná acmhainní atá inrochtana ag aitheantóirí URI uathúla a léiriú, agus iad a ionramháil ag baint úsáide as modhanna caighdeánacha HTTP.

Coincheapa Bunúsacha API REST

Cad is API ann? Is comhéadan é a chabhraíonn le cláir éagsúla idirghníomhú lena chéile. Sainmhíníonn sé conas is féidir iarratais a dhéanamh agus cad iad na freagraí is féidir a fháil. Feidhmíonn API mar bhonn chun córais éagsúla a chomhtháthú agus is cuid bhunúsach é de fhorbairt feidhmchlár nua-aimseartha.

Cad is REST ann? Is stíl ailtireachta í atá bunaithe ar phrionsabail a fhágann go bhfuil sé éasca agus intuigthe seirbhísí gréasáin a úsáid. Tá sé bunaithe ar phrótacail HTTP agus úsáideann sé modhanna caighdeánacha, a phléifear níos déanaí. Tá a aitheantóir uathúil féin (URI) ag gach acmhainn atá inrochtana tríd an API, rud a fhágann go bhfuil sé éasca rochtain a fháil uirthi.

Prionsabail Oibriúcháin REST API

Is iad na cinn is mó ná:

1. Cliant-freastalaí. Éascaíonn deighilt chodanna an chliaint agus an fhreastalaí forbairt agus modhnú neamhspleách ar an dá thaobh.
2. Neamh-stáisiúnacht. Ní stórálann an freastalaí staid iarratais an chliaint, rud a fhágann go bhfuil gach iarratas neamhspleách agus féinleor.
3. Taisceadh: Cuidíonn an cumas sonraí freagartha a thaisceadh le feidhmíocht feidhmchlár a fheabhsú trí líon na n-iarratas arís agus arís eile chuig an bhfreastalaí a laghdú.
4. Comhéadan aontaithe. Simplíonn sé an t-idirghníomhaíocht agus déanann sé córais níos intuartha trí eilimintí caighdeánacha a úsáid.
5. Córas il-shraith. Is féidir leis an ailtireacht a bheith comhdhéanta de roinnt sraitheanna, agus gach ceann acu freagrach as gnéithe sonracha den chóras. Méadaíonn sé seo slándáil agus inrialaitheacht.
6. Cód ar iarratas. Seoltar chuig an gcliant é chun cumais an fheidhmchláir a leathnú.

Buntáistí a bhaineann le REST API

Tá go leor buntáistí ag baint le húsáid an uirlis seo.

1. Inscálaitheacht: Trí na comhpháirteanna cliant agus freastalaí a dheighilt, is féidir an feidhmchlár a scálú go héasca.
2. Solúbthacht. Tacaíonn REST API le go leor teangacha agus ardán ríomhchlárúcháin, rud a chuireann ar chumas comhtháthú córas éagsúil.
3. Feidhmíocht: Feabhsaíonn úsáid taisceála luas freagartha agus laghdaíonn sé ualach an fhreastalaí.
4. Slándáil: Cuidíonn ailtireacht an chórais ilchisealach le slándáil a fheabhsú trí ligean d’acmhainní ríthábhachtacha a bheith leithlisithe.

In ainneoin na buntáistí soiléire a bhaineann le REST, tá teicneolaíochtaí eile ar an margadh freisin, amhail SOAP agus GraphQL. Cé go n-úsáidtear an chéad cheann in iarratais shonracha agus go soláthraíonn sé a ghnéithe féin, is é Facebook a d'fhorbair an dara ceann. Is rogha eile seachas REST é GraphQL. Tá sé níos oiriúnaí do thionscadail mhórscála.

Conas a oibríonn API REST?

Is féidir an próiseas idirghníomhaíochta idir an cliant agus an freastalaí a roinnt ina roinnt céimeanna:

1. Ag seoladh iarratais. Seolann an cliant sonraí chuig an bhfreastalaí, agus é á fhormáidiú de réir dhoiciméadacht an API.
2. Fíordheimhniú. Seiceálann an freastalaí cearta rochtana an chliaint. Má theipeann ar an bhfíordheimhniú, cuirtear earráid 403 ar ais.
3. Próiseáil iarratais. Tar éis fíordheimhniú rathúil, faigheann an freastalaí an t-iarratas, déanann sé na manipulálacha riachtanacha agus gineann sé freagra.
4. Freagra á thabhairt ar ais. Seolann an freastalaí freagra chuig an gcliant. Tá stádas forghníomhaithe an ordaithe agus na sonraí iarrtha ann.

Modhanna HTTP in API REST

Úsáidtear modhanna clasaiceacha HTTP chun oibriú le hacmhainní:

• GET : Úsáidtear é seo chun sonraí a aisghabháil (mar shampla, tugann GET /cities liosta cathracha ar ais);
• POST : Úsáidtear é chun acmhainní nua a chruthú (e.g. cuireann POST /istanbul caifé nua leis in Iostanbúl);
• PUT : Úsáidtear é seo chun acmhainní atá ann cheana a nuashonrú (mar shampla, ceadaíonn PUT /cities duit liosta na gcathracha a athrú);
• DELETE : Úsáidtear é seo chun acmhainní a scriosadh (m.sh. scriosann DELETE /istanbul an caifé in Iostanbúl).

Seolann gach iarratas HTTP cód stádais a léiríonn toradh na hoibríochta. Léiríonn cód a thosaíonn le 2 rath, agus léiríonn cóid a thosaíonn le 4 nó 5 earráidí.

Tá REST API ina chaighdeán i bhforbairt seirbhísí gréasáin, ag soláthar uirlis mhaith d'úsáideoirí chun réitigh sholúbtha agus inscálaithe a thógáil. Tá a phrionsabail agus a buntáistí tar éis cur lena tóir agus lena úsáid fhorleathan i réimsí éagsúla - ó fheidhmchláir ghréasáin bheaga a chruthú go córais dáilte casta. Sa réamhrá ardleibhéil seo ar REST API, féachfaimid níos géire ar a phríomhchodanna, déanfaimid comparáid idir é agus teicneolaíochtaí eile, pléifimid úsáid REST sa chleachtas, agus pléifimid na hionchais dá fhorbairt freisin.

Cineálacha agus formáidí sonraí agus tú ag obair le REST API

Agus tú ag idirghníomhú le REST API, tá sé tábhachtach machnamh a dhéanamh ar na formáidí sonraí a úsáidtear. Is é JSON (javascript) an fhormáid is coitianta, atá éasca le léamh agus le scríobh, rud a fhágann go bhfuil sé oiriúnach le haghaidh aistriú sonraí. Mar sin féin, úsáidtear formáidí eile ar nós XML agus HTML uaireanta. Féadfaidh rogha na formáide sonraí a bheith ag brath ar riachtanais an fheidhmchláir agus ar roghanna na bhforbróirí. Tacaíonn an fhormáid JSON le struchtúir sonraí casta agus soláthraíonn sé úsáid eacnamaíoch bandaleithead, rud atá ina bhuntáiste eile de chuid REST APIs.

Fíordheimhniú agus Údarú

Is gné thábhachtach í an tslándáil agus tú ag obair le APIanna REST. Ceann de na modhanna fíordheimhnithe is ea úsáid comharthaí. Cinntíonn sé seo rochtain shlán ar acmhainní faoi chosaint. Ceann de na modhanna is coitianta is ea úsáid comharthaí JWT. Ligeann an modh seo don chliant rochtain a fháil ar an API ar feadh tréimhse áirithe ama tar éis an fhíordheimhnithe. Ní gá don fhreastalaí staid a stóráil, rud a fheabhsaíonn an coincheap "gan stát" atá i gceist le REST.

Ina theannta sin, is féidir forlíonadh a dhéanamh ar fhíordheimhniú den sórt sin le OAuth 2.0. Cuireann sé seo ciseal breise cosanta leis agus simplíonn sé comhtháthú le líonraí sóisialta agus ardáin eile.

API REST agus Feidhmchláir Shoghluaiste

Le méadú ag teacht ar an tóir atá ar fhóin chliste, tá REST API ina uirlis thábhachtach d’fhorbróirí atá ag cruthú feidhmchlár soghluaiste. Trí úsáid a bhaint as REST API, is féidir le feidhmchláir idirghníomhú le freastalaithe iargúlta, sonraí a fháil agus a nuashonrú i bhfíor-am. Dá bhrí sin, is féidir leat feidhmchláir chasta a chruthú: teachtairí, líonraí sóisialta agus réitigh bhogearraí eile a éilíonn rochtain ardluais ar fhaisnéis.

Sampla de REST API i bhfeidhmchlár praiticiúil

Chun tuiscint níos fearr a fháil ar API REST, féachaimis ar shampla hipitéiseach d’oibriú le API chun leabharlann a bhainistiú. Glacaimis leis go bhfuil API RESTful againn a ligeann duit an méid seo a leanas a dhéanamh:

• liosta leabhar a fháil - is féidir leis an gcliant iarratas GET a dhéanamh chuig /books chun faisnéis a fháil faoi na leabhair uile atá ar fáil;
• leabhar nua a chur leis - más gá, is féidir leis an gcliant iarratas POST a sheoladh chuig /books le sonraí faoin leabhar nua i bhformáid JSON;
• Faisnéis leabhair a cheartú - chun faisnéis faoi leabhar atá ann cheana a athrú, bain úsáid as iarratas PUT chuig /books/{id} , áit a seasann {id} d’aitheantóir uathúil an leabhair;
• leabhar a scriosadh - chun an oibríocht a dhéanamh, is féidir leat iarratas DELETE a sheoladh chuig an URI céanna.

Léiríonn na samplaí simplí seo conas is féidir bainistíocht acmhainní éifeachtach a chur i bhfeidhm ag baint úsáide as an REST API.

Uirlisí agus teicneolaíochtaí le haghaidh oibriú le REST API

Tá go leor gnéithe agus leabharlann ann a fhágann go bhfuil sé níos éasca comhoibriú a dhéanamh. Mar shampla, is feidhmchlár coitianta é Postman a ligeann d’fhorbróirí iarratais a sheoladh, freagraí a thástáil agus a anailísiú. Ligeann uirlisí eile, amhail Swagger, duit APIanna a dhoiciméadú agus cód a ghiniúint go huathoibríoch i dteangacha ríomhchlárúcháin éagsúla.

I Python, is féidir leat leabharlanna (Iarratais) a úsáid, a sholáthraíonn comhéadan simplí chun iarratais HTTP a sheoladh agus freagraí a phróiseáil. I JavaScript, go háirithe i bhforbairt tosaigh, bain úsáid as an Fetch API nó Axios.

Conclúid

Tá REST API fós ar cheann de na huirlisí is mó tóir le haghaidh idirghníomhaíochta idir cliaint agus freastalaithe. Soláthraíonn a phrionsabail solúbthacht, inscálaitheacht agus éascaíocht úsáide, rud a fhágann gur réiteach idéalach é do fhormhór na bhfeidhmchlár gréasáin nua-aimseartha. In ainneoin teacht chun cinn roghanna malartacha (GraphQL).