Intro
Gydag ychydig o gliciau ar bwrdd gwaith neu ddyfais, gall rhywun brynu, gwerthu neu gyhoeddi unrhyw beth, unrhyw bryd. Yn union sut mae'n digwydd? Sut mae gwybodaeth mynd o fan hyn i fan yna? Yr arwr heb ei gydnabod yw'r API.
Beth yw API?
Mae API yn sefyll am RHYNGWYNEB RHAGLENNU CAIS. Mae API yn mynegi cydran meddalwedd, ei gweithrediadau, mewnbynnau, allbynnau, a mathau sylfaenol. Ond sut mae esbonio'r API mewn Saesneg clir? Mae'r API yn gweithredu fel negesydd sy'n trosglwyddo'ch cais o raglen ac yn danfon yr ymateb yn ôl i chi.
Enghraifft 1: Pan fyddwch chi'n chwilio am deithiau hedfan ar-lein. Rydych chi'n rhyngweithio â gwefan y cwmni hedfan. Mae'r wefan yn manylu ar y seddi a chost yr awyren ar y dyddiad a'r amser penodol hwnnw. Chi sy'n dewis eich pryd o fwyd neu seddi, bagiau, neu geisiadau anifeiliaid anwes.
Ond, os nad ydych yn defnyddio gwefan uniongyrchol y cwmni hedfan neu ac yn defnyddio asiant teithio ar-lein sy'n cyfuno data gan lawer o gwmnïau hedfan. I gael y wybodaeth, mae cais yn rhyngweithio ag API y cwmni hedfan. Yr API yw'r rhyngwyneb sy'n mynd â data o wefan yr asiant teithio i system y cwmni hedfan.
Mae hefyd yn cymryd ymateb y cwmni hedfan ac yn danfon yn ôl yn syth. Mae hyn yn hwyluso'r rhyngweithio rhwng y gwasanaeth teithio, a systemau'r cwmni hedfan - i archebu'r hediad. Mae API yn cynnwys llyfrgell ar gyfer arferion, strwythurau data, dosbarthiadau gwrthrychau, a newidynnau. Er enghraifft, gwasanaethau SOAP a REST.
Enghraifft 2: Mae Best Buy yn sicrhau bod Bargen y Dydd yn cynnig pris arbennig ar ei wefan. Mae'r un data hwn yn ei gymhwysiad symudol. Nid yw'r ap yn poeni am y system brisio fewnol - gall alw API Bargen y Dydd a gofyn, beth yw'r pris arbennig? Mae Best Buy yn ymateb gyda'r wybodaeth y gofynnwyd amdani mewn fformat safonol y mae'r ap yn ei ddangos i'r defnyddiwr terfynol.
Enghraifft3: Mae APIs ar gyfer cyfryngau cymdeithasol yn hollbwysig. Gall defnyddwyr gyrchu cynnwys a chadw nifer y cyfrifon a chyfrineiriau y maent yn cadw golwg arnynt yn isel, fel y gallant gadw pethau'n syml.
- Twitter API: Rhyngweithio â'r rhan fwyaf o swyddogaethau Twitter
- Facebook API: Ar gyfer taliadau, data defnyddwyr, a mewngofnodi
- Instagram API: Tagiwch ddefnyddwyr, edrychwch ar luniau tueddiadol
Beth am REST & SOAP APIs?
SOAP ac REST defnyddio gwasanaeth sy'n cymryd llawer o API, a elwir yn Web API. Nid yw gwasanaeth gwe yn dibynnu ar unrhyw wybodaeth flaenorol o wybodaeth. Mae SOAP yn brotocol gwasanaeth gwe sy'n annibynnol ar blatfform ysgafn. Protocol negeseuon sy'n seiliedig ar XML yw SOAP. Yn wahanol i wasanaeth gwe SOAP, mae gwasanaeth Restful yn defnyddio pensaernïaeth REST, a adeiladwyd ar gyfer cyfathrebu pwynt-i-bwynt.
Gwasanaeth Gwe SEBON
- Anfonwr SEBON – creu a throsglwyddo neges.
- Derbynnydd SEBON - yn cael ac yn prosesu'r neges.
- Cyfryngwr SEBON - derbyn a phrosesu blociau pennawd.
Gwasanaeth Gwe RESTful
Mae Trosglwyddo Cyflwr Cynrychioliadol (REST) yn ymwneud â'r berthynas rhwng y cleient a'r gweinydd a sut mae'r wladwriaeth yn prosesu. Pensaernïaeth Rest, mae Gweinydd REST yn darparu mynediad adnoddau i'r cleient. Mae Rest yn trin y darllen ac yn addasu neu ysgrifennu'r adnoddau. Dynodydd Unffurf (URI) yn nodi adnoddau i gynnwys dogfen. Bydd hyn yn dal y cyflwr adnoddau.
Mae REST yn ysgafnach na phensaernïaeth SEBON. Mae'n dosrannu JSON, iaith y gall pobl ei darllen sy'n galluogi rhannu data a data haws ei ddefnyddio, yn lle XML a ddefnyddir gan bensaernïaeth SOAP.
Mae sawl egwyddor ar gyfer dylunio Gwasanaeth Gwe Restful, sef:
- Cyfeiriad - Dylai fod gan bob adnodd o leiaf un URL.
- Diwladwriaeth – Mae gwasanaeth Restful yn wasanaeth heb wladwriaeth. Mae cais yn annibynnol ar unrhyw geisiadau blaenorol gan y gwasanaeth. Mae HTTP trwy ddyluniad yn brotocol heb wladwriaeth.
- Cacheable - Data wedi'i nodi fel storfeydd y gellir eu storio yn y system ac yn cael eu hailddefnyddio yn y dyfodol. Fel yr ymateb i'r un cais yn lle cynhyrchu'r un canlyniadau. Mae cyfyngiadau storfa yn galluogi marcio data ymateb fel rhai y gellir eu storio neu na ellir eu storio.
- Rhyngwyneb unffurf - Yn caniatáu rhyngwyneb cyffredin a safonol i'w ddefnyddio ar gyfer mynediad. Y defnydd o gasgliad diffiniedig o ddulliau HTTP. Mae cadw at y cysyniadau hyn yn sicrhau bod gweithredu REST yn ysgafn.
Manteision REST
- Yn defnyddio fformat symlach ar gyfer negeseuon
- Yn cynnig effeithlonrwydd hirdymor cryfach
- Mae'n cefnogi cyfathrebu heb wladwriaeth
- Defnyddiwch safonau HTTP a gramadeg
- Mae data ar gael fel adnodd
Anfanteision REST
- Methu â safonau gwasanaeth Gwe fel Trafodion Diogelwch ac ati.
- Nid yw ceisiadau REST yn raddadwy
Cymhariaeth REST vs SEBON
Gwahaniaethau rhwng gwasanaethau gwe SOAP a REST.
Gwasanaeth Gwe SEBON | Gwasanaeth Gwe Rest |
Angen llwyth tâl mewnbwn trwm o'i gymharu â REST. | Mae REST yn ysgafn gan ei fod yn defnyddio URI ar gyfer ffurflenni data. |
Mae newid mewn gwasanaethau SOAP yn aml yn arwain at newid sylweddol yn y cod ar ochr y cleient. | Nid yw newid mewn gwasanaethau yn narpariaeth gwe REST yn effeithio ar god ochr y cleient. |
Math XML yw'r math dychwelyd bob amser. | Yn darparu amlbwrpasedd o ran ffurf y data a ddychwelwyd. |
Protocol neges yn seiliedig ar XML | Protocol pensaernïol |
Angen llyfrgell SEBON ar ddiwedd y cleient. | Nid oes angen unrhyw gefnogaeth llyfrgell a ddefnyddir fel arfer dros HTTP. |
Yn cefnogi WS-Security a SSL. | Yn cefnogi SSL a HTTPS. |
Mae SEBON yn diffinio ei ddiogelwch ei hun. | Mae gwasanaethau gwe RESTful yn etifeddu mesurau diogelwch o'r cludiant sylfaenol. |
Mathau o Bolisïau Rhyddhau API
Polisïau rhyddhau ar gyfer API yw:
Polisïau rhyddhau preifat:
Dim ond at ddefnydd mewnol cwmni y mae'r API ar gael.
Polisïau rhyddhau partner:
Mae'r API ar gael ar gyfer partneriaid busnes penodol yn unig. Gall y cwmnïau reoli ansawdd yr API oherwydd y rheolaeth dros bwy all gael mynediad iddo.
Polisïau rhyddhau cyhoeddus:
Mae'r API at ddefnydd y cyhoedd. Mae argaeledd y polisïau rhyddhau ar gael i'r cyhoedd. Enghraifft: Microsoft Windows API ac Apple's Cocoa.
Casgliad
Mae APIs yn bresennol ym mhobman, p'un a ydych chi'n archebu taith awyren neu'n ymgysylltu â chymwysiadau cyfryngau cymdeithasol. Mae API SOAP yn seiliedig ar gyfathrebiadau XML, mae'n wahanol i REST API gan nad oes angen unrhyw ffurfweddiad arbennig arno.
Dylai dylunio gwasanaethau Rest Web lynu at rai cysyniadau, gan gynnwys mynd i'r afael, diffyg cyflwr, storfa, a rhyngwyneb safonol. Gellir rhannu rheolau rhyddhau API yn dri chategori: APIs preifat, APIs partner, ac APIs cyhoeddus.
Diolch am ddarllen yr erthygl hon. Edrychwch ar ein herthygl ar Ganllaw i Diogelwch API 2022.