O le a le API ma Mea e mafaufau i ai pe a atiaʻe se API?

API (Application Programming Interface) o se seti o faʻatonuga, tulaga, poʻo manaʻoga e mafai ai e se polokalama poʻo se app ona faʻaogaina foliga poʻo auaunaga o se isi app, platform, poʻo masini mo auaunaga sili atu. I se faapuupuuga, o se mea e mafai ai e apps ona fesootai le tasi i le isi.

 

O le API o le fa'avae o mea uma e fa'atatau i fa'amaumauga pe mafai ai ona feso'ota'i i le va o oloa po'o tautua se lua. E fa'amalosia ai se talosaga feavea'i po'o se fa'avae e fa'asoa ai ana fa'amaumauga i isi polokalame/fa'avae ma fa'afaigofie le poto masani a le tagata e aunoa ma le fa'aaofia ai o tagata atia'e. 

E le gata i lea, e faʻaumatia e API le manaʻoga e fausia se faʻatusa faʻatusa poʻo se polokalama mai le sasa. E mafai ona e faʻaogaina le mea o iai nei poʻo se isi faʻavae poʻo le app. Ona o nei mafuaʻaga, o le faʻagasologa o le atinaʻeina o le API o se taulaiga mo le au atinaʻe faʻaoga ma faʻatonu kamupani.

 

Galuega ole API

Fa'apea na e tatalaina se XYZ app po'o se upega tafa'ilagi e tusi ai se vaalele. Na e fa'atumuina le fomu, e aofia ai taimi e alu ese ai ma le taunu'u mai, aai, fa'amatalaga o le va'alele, ma isi fa'amatalaga talafeagai, ona tu'uina atu lea. I totonu o se vaega o sekone, o se lisi o vaalele e aliali mai i luga o le lau faʻatasi ma le tau, taimi, avanoa nofoa, ma isi faʻamatalaga. E faapefea ona tupu moni lenei mea?

 

Ina ia tuʻuina atu faʻamaumauga faʻamaonia, na tuʻuina atu e le faʻasalalauga se talosaga i le upega tafaʻilagi a le kamupani vaalele e faʻaoga i latou faʻamaumauga ma maua faʻamatalaga talafeagai e ala i le faʻaogaina o polokalame faʻaoga. O le upega tafaʻilagi na tali atu i faʻamatalaga na tuʻuina atu e API Integration i luga o le faʻavae ma faʻaalia e le faʻailoga i luga o le lau.

 

O iinei, o le polokalama / faʻapipiʻi ma le upega tafaʻilagi a le kamupani vaalele e fai ma faʻaiʻuga ae o le API o le vaeluaga lea e faʻafaigofie ai le faʻasoaina o faʻamatalaga. Pe a talanoa e uiga i le faʻafesoʻotaʻi o faʻamatalaga, o le API e galue i ni auala se lua, e taʻua, REST (Faʻaliliuina o le Setete) ma le SOAP (Simple Object Access Protocol).

 

E ui o auala uma e lua e maua ai iʻuga lelei, a telefoni feaveaʻi o le telefoni e sili atu le REST nai lo le SOAP talu ai SOAP API e mamafa ma faʻalagolago i luga ole faʻavae.

 

Ina ia malamalama i le olaga API ma le iloa-pe faapefea ona galue le API i auiliiliga, fa'afeso'ota'i a matou tagata popoto i aso nei!

 

Meafaigaluega mo le Atinae o se API

E ui o loʻo i ai le tele o mea faigaluega faʻapipiʻi API ma tekinolosi faʻapipiʻiina i le faagasologa o le fatuina o se API, o tekinolosi atinaʻe API lauiloa ma meafaigaluega mo le atinaʻeina o API mo tagata atiaʻe o:

 

• Apigee

O le Google's API pulega e tu'uina atu e fesoasoani i le au atina'e ma le aufaipisinisi e manumalo i suiga fa'atekinolosi e ala i le toe fa'atuina o se API Integration approach.

 

• APIMatic ma API Transformer

O isi meafaigaluega lauiloa mo le atinaʻeina o API. Latou te ofoina atu meafaigaluega faʻapitoa faʻapitoa e fausia ai SDK sili ona lelei ma snippet code mai faʻasologa faʻapitoa API ma suia i latou i isi faʻatulagaga faʻapitoa, e pei ole RAML, API Blueprint, ma isi.

 

• API Saienisi 

O lenei meafaigaluega e faʻaaoga muamua mo le iloiloga o le faʻatinoga o API i totonu ma fafo API.

 

• API Fa'atonuga e leai se fa'aumau 

O nei oloa e fesoasoani i le au atinaʻe telefoni feaveaʻi i le mamanuina, fausiaina, lolomiina, ma le faʻafeiloaʻi o API faʻatasi ai ma le fesoasoani o mea faʻapipiʻi i luga o le ao.

 

• API-Platform

O se tasi lea o faʻamatalaga faʻapipiʻi PHP e talafeagai mo le atinaʻeina o le API web.

 

• Auth0

Ose fofo fa'asinomaga fa'aoga e fa'amaonia ma fa'atagaina API.

 

• ClearBlade

Ose API pulega e tu'uina atu mo le taliaina o tekinolosi IoT i lau fa'agasologa.

 

• GitHub

Ole 'au'aunaga talimalo talimalo git open-source e mafai ai e le au atiaʻe ona faʻatautaia faila faila, toso talosaga, faʻatonuga o faʻamatalaga, ma faʻamatalaga o loʻo tufatufa atu ile vaega. E fa'ataga fo'i latou te fa'asaoina a latou code i fale teu oloa.

 

• Falemeli

O le mea autu o se mea faigaluega API e faʻamalosia ai le au atiaʻe e faʻatautaia, suʻega, pepa, ma iloilo le faʻatinoga o latou API.

 

• Faasee

O se fa'avae fa'amalama e fa'aogaina mo le atina'eina o polokalame API. Tekinolosi tetele e pei o GettyImages ma Microsoft faʻaaoga Swagger. E ui ina tumu le lalolagi i API, ae o loʻo i ai pea se avanoa tele i le faʻaaogaina o faʻamanuiaga o tekinolosi API. A'o faia e nisi API le tu'ufa'atasiga i le app o se savili, o isi e liua i se miti taufaafefe.

 

E tatau ona i ai ni uiga o se API Lelei

• Su'ega taimi fa'ailoga po'o Su'esu'e e fa'atatau

Ole vaega pito sili ole API e tatau ona iai ile app ole Su'iga taimi/Su'esu'e ile ta'iala. E tatau i le API ona fa'atagaina tagata fa'aoga e su'e fa'amaumauga e fa'atatau i ta'iala eseese, pei o se aso. E mafua ona o suiga (faʻafouina, faʻasaʻo ma tape) tatou te mafaufau i ai i le maeʻa ai o le faʻasologa muamua o faʻamaumauga.

 

• Paging 

O le tele o taimi, e tupu tatou te le manaʻo e vaʻai i faʻamatalaga atoa ua suia, ae na o sina vaaiga. I se tulaga faapena, e tatau ona mafai e le API ona fuafua pe fia le tele o faʻamatalaga e faʻaalia i le tasi alu ma pe o le a le taimi. E tatau foi ona logoina le tagata fa'au'u e uiga i le leai. o itulau o fa'amaumauga o totoe.

 

• Faʻasologa

Ina ia faʻamautinoa e maua e le tagata faʻauʻu itulau uma o faʻamaumauga taʻitasi, e tatau i le API ona faʻamalosia tagata faʻaoga e faʻavasega faʻamaumauga e tusa ai ma le taimi o suiga poʻo se isi tulaga.

 

• JSON Lagolago po'o RESTA

E ui lava e le fa'amalosia, e lelei le manatu o lau API e MAMAFA (po'o le tu'uina atu o le lagolago a le JSON(REST)) mo le atina'e lelei o le API. O le REST APIs e leai ni fa'ailoga, mama-mamafa, ma tu'u oe e toe taumafai le fa'auluina o le fa'agaioiga telefoni feavea'i pe a le manuia. E faigata tele lenei mea ile tulaga ole SOAP. E le gata i lea, o le syntax a le JSON e foliga tutusa ma le tele o gagana polokalame, lea e faigofie ai mo se tagata e faia le telefoni feaveaʻi ona faʻavasegaina i soʻo se isi gagana.

 

• Fa'atagaga e ala ile OAuth

E mana'omia fo'i le fa'atagaina o lau fa'aoga polokalame e ala i le OAuth talu ai e sili atu le vave nai lo isi metotia e te mana'omia e kiliki i luga o le ki ma ua mae'a.

 

I se faapuupuuga, e tatau ona laʻititi le taimi o gaioiga, taimi tali lelei, ma maualuga le saogalemu. E taua tele le tuʻuina atu o taumafaiga i le atinaʻeina o API faʻataʻitaʻiga sili mo le faʻamautuina o lau talosaga, pe a uma, e faʻatatau i le faʻaputuga o faʻamaumauga.

 

Fa'amatalaga o API

 

1. API Key - Pe a talosaga se siaki API e ala i se parakalafa ma malamalama i le tagata talosaga. Ma o le tulafono faʻatagaina na pasi atu i le ki talosaga ma fai mai o se API KEY.
2. Fa'ai'uga - Pe a fegalegaleai le API mai le tasi faiga ma se isi faiga, o le tasi pito o le ala feso'ota'iga e ta'ua o se fa'ai'uga.
3. JSON - O mea JSON poʻo Javascript o loʻo faʻaaogaina e avea ma faʻamaumauga o faʻamatalaga e faʻaaogaina mo API talosaga faʻasologa ma le tino tali. 
4. GET – Fa'aaoga le auala HTTP a le API mo le mauaina o punaoa
5. POST - O le RESTful API's HTTP auala mo le fausiaina o punaoa. 
6. OAuth – O se fa'ava'a fa'atagaina masani e maua ai le avanoa mai le itu a le tagata fa'aoga e aunoa ma le fa'asoaina o so'o se fa'ailoga. 
7. MOTO - Le polokalame e faʻaleleia ai le lelei o fesoʻotaʻiga i le va o masini / faiga e lua. E fa'asoa e REST na'o fa'amaumauga e mana'omia ae le o fa'amaumauga atoa. O faiga fa'amalosia i luga o lenei fausaga ua ta'ua o 'RESTful' faiga, ma o le fa'ata'ita'iga sili ona lofituina o faiga RESTful o le World Wide Web.
8. SOAP - SOAP poʻo le Simple Object Access Protocol o se feʻau feʻau mo le faʻasoaina o faʻamatalaga faʻatulagaina i le faʻatinoina o auaunaga i luga ole laiga i fesoʻotaʻiga komepiuta.
9. Latency - O loʻo faʻamatalaina o le aofaʻi o le taimi na faʻaalu e se faʻagasologa ole atinaʻe API mai le talosaga ile tali.
10. Fa'atapula'aina o Fuafuaga - o lona uiga o le fa'atapula'aina o le numera o talosaga e mafai e se tagata fa'aoga ona lavea ile API ile taimi.

 

Fa'ata'ita'iga Sili mo le Fausiaina o le API Sa'o

• Fa'aaoga le Fa'amalo

App Throttling o se faiga sili e mafaufau i ai mo le toe faʻafeiloaʻi o le tele o feoaiga, API faʻasaʻo, ma puipuia mai osofaiga a le DoS (Denial of Service).

 

• Mafaufau i lau faitotoa API o le Enforcer

A'o fa'atūina tulafono fa'apipi'i, fa'aogaina o ki API, po'o le OAuth, e tatau ona manatu le faitoto'a API o le fa'amalosi. E tatau ona avea o se leoleo e faʻatagaina naʻo tagata faʻaoga saʻo e maua le avanoa i faʻamatalaga. E tatau ona fa'amalosia oe e fa'ailoga le fe'au pe fa'asa'o fa'amatalaga fa'alilolilo, ma fa'apea, iloilo ma pulea pe fa'apefea ona fa'aogaina lau API.

 

• Fa'ataga le fa'aogaina o le auala HTTP

Talu ai o nisi o sui e lagolagoina GET ma POST auala, e tatau ona e faʻatagaina lau RESTful API e faʻamalo le auala HTTP. Mo le faia o lea mea, faʻaaoga le masani HTTP Header X-HTTP-Method-Override.

 

• Iloilo API ma atinaʻe

I le taimi nei, e mafai ona maua suʻesuʻega moni, ae faʻafefea pe a masalomia le API server o loʻo i ai le galo manatua, faʻafefe PPU, poʻo isi faʻafitauli? Ina ia mafaufau i ia tulaga, e le mafai ona e taofia se tagata atiae i tiute. Ae ui i lea, e mafai ona e faia lenei mea faigofie e ala i le faʻaaogaina o le tele o meafaigaluega o loʻo maua i le maketi, pei o le AWS cloud watch.

 

• Ia mautinoa le saogalemu

E tatau ona e faʻamautinoa o loʻo saogalemu lau tekonolosi API ae le o le tau o le faʻaoga-faauo. Afai e faʻaalu e se tagata faʻaoga sili atu nai lo le 5 minute i luga o le faʻamaoniga o lona uiga o lau API e mamao mai le faʻaoga-tagata. E mafai ona e fa'aogaina fa'amaoniga fa'avae e fa'amautu ai lau API.

 

• pepa aloaia

Mulimuli ae leai se mea itiiti, e aoga tele le fatuina o faʻamaumauga lautele mo se API mo polokalama feaveaʻi e faʻatagaina ai isi tagata faʻapipiʻi telefoni feaveaʻi faigofie ona malamalama i le faagasologa atoa ma faʻaoga faʻamatalaga mo le ofoina atu o se poto masani faʻaoga. I se isi faaupuga, o faʻamaumauga lelei API i le faagasologa o le atinaʻeina lelei o le API o le a faʻaitiitia ai le taimi o le faʻatinoina o le poloketi, tau o le poloketi ma faʻaleleia le lelei o tekinolosi API.