Intro
Faatasi ai ma ni nai kiliki i luga o le laulau poʻo se masini, e mafai e se tasi ona faʻatau, faʻatau atu pe lolomi soʻo se mea, i soo se taimi. E faapefea ona tupu? E faapefea faʻamatalaga alu mai iinei i iina? O le toa e le iloa o le API.
O le a le API?
API e fa'atusa mo se FA'ATA'IGA POLOKALAME FA'AVAE. O le API o lo'o fa'aalia se vaega fa'akomepiuta, o ana fa'agaioiga, mea fa'aoga, galuega faatino, ma ituaiga fa'avae. Ae faʻafefea ona e faʻamatalaina le API ile Igilisi manino? O le API o loʻo galue o se avefeʻau e tuʻuina atu lau talosaga mai se talosaga ma toe tuʻuina atu le tali ia te oe.
Faataʻitaʻiga 1: A'o e su'e va'alele i luga ole laiga. E te fegalegaleai ma le upegatafa'ilagi a le kamupani vaalele. O lo'o fa'amatalaina e le upega tafa'ilagi le nofoa ma le tau o le va'alele i lea aso ma le taimi. E te filifilia lau 'aiga po'o le nofoa, ato, po'o lau fagafao.
Ae, afai e te le o faʻaogaina le upega tafaʻilagi tuusaʻo a le kamupani vaʻalele poʻo ma o loʻo faʻaaogaina se ofisa femalagaaʻi i luga ole laiga e tuʻufaʻatasia faʻamatalaga mai le tele o kamupani vaalele. Ina ia maua le faʻamatalaga, o se talosaga e fegalegaleai ma le API a le kamupani vaalele. O le API o le atinaʻe lea e ave faʻamaumauga mai le upega tafaʻilagi a le ofisa malaga i le faiga a le kamupani vaalele.
E mana'omia fo'i le tali a le kamupani va'alele ma toe fa'afo'i sa'o. O lenei mea e faafaigofie ai le fegalegaleaiga i le va o le auaunaga femalagaaʻi, ma le vaalele 'faiga - e tusi ai le vaalele. API's e aofia ai se faletusi mo masani, fausaga faʻamaumauga, vasega mea, ma fesuiaiga. Mo se faʻataʻitaʻiga, SOAP ma REST auaunaga.
Faataʻitaʻiga 2: Best Buy e fa'apitoa le tau o Deal of the Day i lana upega tafa'ilagi. O lenei lava faʻamatalaga o loʻo i totonu o lana telefoni feaveaʻi. E le popole le app i le faiga o tau i totonu - e mafai ona valaau le Deal of the Day API ma fesili, o le a le tau faʻapitoa? Best Buy e tali atu i faʻamatalaga o loʻo talosagaina i se faʻatulagaga masani e faʻaalia e le app i le tagata faʻaaoga mulimuli.
Faataitaiga3: APIs mo faʻasalalauga lautele e taua tele. E mafai e tagata fa'aoga ona maua le anotusi ma tausia le numera o fa'amatalaga ma upu fa'aulu latou te siaki le maualalo, ina ia mafai ona latou fa'afaigofie mea.
- Twitter API: Fegalegaleai ma le tele o galuega Twitter
- Facebook API: Mo totogi, faʻamatalaga tagata faʻaoga, ma saini
- Instagram API: Fa'ailoga tagata fa'aoga, va'ai ata fa'asolo
Ae faapefea REST & SOAP API?
moli ma mapu fa'aaoga se 'au'aunaga e fa'aaoga ai le API, e ta'ua ole Web API. 'Au'aunaga i luga ole laiga e le fa'alagolago i so'o se malamalama muamua o fa'amatalaga. SOAP ose 'upega tafa'ilagi fa'akomepiuta e mama fa'avae-tuto'atasi. O le SOAP o se faʻasalalauga feʻau faʻavae XML. E le pei o le SOAP web service, Restful service e faʻaogaina le fausaga REST, fausia mo fesoʻotaʻiga i le itu-i-itu.
SOAP Web service
- SOAP Sender - fatuina ma faʻasalalau se feʻau.
- SOAP Receiver – maua ma fa'agasolo le fe'au.
- SOAP Intermediary- talia ma fa'agasolo poloka ulutala.
Au'aunaga i luga ole laiga
Representational State Transfer (REST) e fesoʻotaʻi ma le va o le kalani ma le 'auʻaunaga ma le faʻaogaina o le setete. Malologa fausaga, o le REST Server e maua ai punaoa avanoa i le kalani. Malolo e taulimaina le faitau ma le suia po o le tusiaina o punaoa. Uniform Identifier (URI) fa'ailoa puna'oa e iai se pepa. O lenei mea o le a pu'eina ai le tulaga o punaoa.
REST e mama atu nai lo SOAP architecture. E fa'asalalau le JSON, o se gagana e mafai ona faitau tagata e mafai ai ona fa'asoa fa'amaumauga ma fa'afaigofie ona fa'aoga fa'amaumauga, nai lo le XML fa'aaogaina e le SOAP architecture.
E tele fa'avae mo le fuafuaina o le Restful Web Service, o:
- Fa'afeso'ota'i - E tatau ona i ai i punaoa ta'itasi ia le itiiti ifo ma le tasi le URL.
- Statelessness - O se auaunaga malolo o se auaunaga e leai ni setete. Ose talosaga e tutoatasi mai so'o se talosaga ua mavae a le au'aunaga. O le HTTP o loʻo faʻatulagaina se faʻasalalauga e leai ni setete.
- Cacheable - Faʻamaumauga ua faʻailogaina o faleoloa e mafai ona faʻaogaina i totonu o le polokalama ma toe faʻaaogaina i le lumanaʻi. E pei o le tali i le talosaga lava e tasi nai lo le faia o taunuuga tutusa. Fa'agata fa'apolopolo e mafai ai ona fa'ailogaina fa'amaumauga tali e mafai ona fa'aogaina pe leai.
- Feso'ota'iga fa'atasi - Fa'ataga se fa'aoga masani ma fa'ata'atia e fa'aoga mo avanoa. Le faʻaogaina o se aoina faʻamalamalamaina o metotia HTTP. O le tausisia o nei manatu e mautinoa ai, o le faʻatinoga o le REST e mama.
Tulaga lelei ole REST
- Fa'aaogā fa'asologa faigofie mo fe'au
- O lo'o ofoina atu le malosi fa'agata umi
- E lagolagoina fesoʻotaʻiga e leai ni setete
- Fa'aoga tulaga HTTP ma le kalama
- O lo'o maua fa'amaumauga e fai ma puna'oa
Le lelei ole REST
- Le manuia i tulaga o le Upega Tafaʻilagi e pei o le Puipuiga o Fefaʻatauaiga ma isi.
- O talosaga REST e le mafai ona fa'ateleina
FOTO MA FAI FAIFAIFAIGA
Eseesega i le va o SOAP ma REST 'au'aunaga i luga ole laiga.
SOAP Web Service | Malolo le Upega Tafa'ilagi |
Mana'omia le mamafa o uta fa'aoga fa'atusatusa ile REST. | REST e mama ona faʻaaogaina URI mo faʻamaumauga. |
Suiga i auaunaga SOAP e masani ona taʻitaʻia ai se suiga tele i le code ile itu ole tagata o tausia. | E le a'afia le code a le tagata fa'atau ile suiga ile tautua ile REST web provisioning. |
Fa'afo'i ituaiga e masani lava XML ituaiga. | Tuuina atu le faʻaogaina e faʻatatau i foliga o faʻamatalaga toe faafoi. |
O se fa'asalalauga fe'au fa'avae XML | O se fa'ata'ita'iga fa'afale |
Manaomia se faletusi SOAP i le pito o le kalani. | Leai se lagolago faletusi e mana'omia e masani ona fa'aoga ile HTTP. |
Lagolago WS-Security ma SSL. | Lagolago SSL ma HTTPS. |
SOAP e faʻamatalaina lona lava saogalemu. | O 'au'aunaga i luga o le upega tafa'ilagi RESTful e fa'atosina faiga saogalemu mai felauaiga fa'avae. |
Ituaiga o Faiga Fa'asalalauga API
O faiga fa'avae mo API e:
Faiga fa'avae tu'uoti:
O le API e na'o le fa'aoga a le kamupani i totonu.
Faiga fa'avae fa'a-paaga:
O le API e avanoa mo na'o paaga faapisinisi faapitoa. E mafai e kamupani ona pulea le lelei o le API ona o le puleaina o ai e mafai ona maua.
Faiga fa'asalalau fa'alaua'itele:
O le API e mo le fa'aoga lautele. Ole avanoa ole faiga fa'avae e avanoa mo tagata lautele. Faataitaiga: Microsoft Windows API ma Apple's Cocoa.
iʻuga
APIs o loʻo i ai i soʻo se mea, pe o loʻo e faʻasalalau se vaalele pe faʻatasi ma faʻasalalauga faʻasalalau. SOAP API e faʻavae i luga o fesoʻotaʻiga XML, e ese mai le REST API ona e le manaʻomia se faʻatulagaga faʻapitoa.
Fuafuaina o 'au'aunaga i luga ole laiga e tatau ona mulimulita'i i ni manatu fa'apitoa, e aofia ai le mafai ona fa'afeso'ota'i, leai se fa'ailoga, fa'aoga fa'aoga, ma se fa'aoga masani. E mafai ona vaevaeina tulafono fa'amatu'u API i ni vaega se tolu: API tumaoti, API paaga, ma API lautele.
Faafetai mo le faitauina o lenei tusiga. Siaki la matou tusiga i luga o le Guide to API Puipuiga 2022.
