Inona ny API sy ny zavatra tokony hodinihina rehefa mamolavola API?
API (Application Programming Interface) dia toromarika, fenitra, na fepetra ahafahan'ny lozisialy na fampiharana mampiasa endri-javatra na serivisy amin'ny fampiharana, sehatra, na fitaovana hafa ho an'ny serivisy tsara kokoa. Raha fintinina dia zavatra ahafahan'ny apps mifampiresaka.
Ny API no fototry ny fampiharana rehetra mifandraika amin'ny angon-drakitra na mamela ny fifandraisana eo amin'ny vokatra na serivisy roa. Izy io dia manome hery ny fampiharana finday na sehatra iray hizarana ny angonany amin'ny fampiharana/sehatra hafa ary hanamora ny traikefan'ny mpampiasa nefa tsy idiran'ny mpamorona.
Fanampin'izany, ny API dia manafoana ny filana hamorona sehatra na rindrambaiko azo ampitahaina hatrany am-boalohany. Azonao atao ny mampiasa ny sehatra na fampiharana amin'izao fotoana izao. Noho ireo antony ireo, ny fizotry ny fampandrosoana API dia mifantoka amin'ny mpamorona fampiharana sy ny mpitantana orinasa.
Ny fiasan'ny API
Eritrereto hoe nanokatra fampiharana na tranokala XYZ ianao mba hamandrika sidina. Nofenoinao ny taratasy, nampidirinao ny ora fiaingana sy fahatongavana, tanàna, fampahalalana momba ny sidina, ary fampahalalana hafa ilaina, avy eo dia nandefa izany. Ao anatin'ny segondra vitsy dia miseho eo amin'ny efijery ny lisitry ny sidina miaraka amin'ny vidiny, ny fotoana, ny fisian'ny seza ary ny antsipiriany hafa. Ahoana no tena nitrangan'izany?
Mba hanomezana angon-drakitra henjana toy izany, nandefa fangatahana tany amin'ny tranokalan'ny zotram-piaramanidina ny sehatra mba hidirana amin'ny angon-drakitra misy azy ireo sy hahazoana angon-drakitra mifandraika amin'ny alàlan'ny interface programan'ny fampiharana. Namaly tamin'ny angon-drakitra naterin'ny API Integration teo amin'ny lampihazo ny tranokala ary nasehon'ny sehatra teo amin'ny efijery.
Eto, ny fampiharana/sehatra famandrihana sidina sy ny tranokalan'ny zotram-piaramanidina dia miasa ho toy ny teboka farany raha ny API kosa no mpanelanelana amin'ny fanamafisana ny fizotran'ny fizarana data. Raha miresaka momba ny fampitana ireo teboka, ny API dia miasa amin'ny fomba roa, dia ny REST (Fifindran'ny Fanjakana Representante) sy SOAP (Protocol Object Access Protocol).
Na dia samy mitondra vokatra mahomby aza ireo fomba roa ireo, a orinasa fampandrosoana fampiharana finday aleony REST fa tsy SOAP satria mavesatra sy miankina amin'ny sehatra ny SOAP API.
Mba hahatakarana ny tsingerin'ny fiainana API sy ny fomba fiasan'ny API amin'ny antsipiriany, mifandraisa amin'ireo manampahaizanay anio!
Fitaovana hamolavolana API
Na dia be dia be aza ny fitaovana famolavolana API sy teknolojia ampiasaina amin'ny dingan'ny famoronana API, ny teknolojia fampandrosoana API malaza sy fitaovana amin'ny famolavolana API ho an'ny mpamorona dia:
- Apigee
Izy io no mpamatsy fitantanana API an'ny Google izay manampy ny mpamorona sy ny mpandraharaha handresy amin'ny fanovana nomerika amin'ny alàlan'ny fametrahana indray ny fomba fiasa API Integration.
- APIMatic sy API Transformer
Ireo dia fitaovana malaza hafa ho an'ny fampandrosoana API. Manolotra fitaovana famokarana automatique be pitsiny izy ireo mba hananganana SDK avo lenta sy sombin-kaody avy amin'ny endrika manokana amin'ny API ary hanova azy ireo ho endrika voafaritra hafa, toy ny RAML, API Blueprint, sns.
- API Science
Ity fitaovana ity dia ampiasaina indrindra amin'ny fanombanana ny fahombiazan'ny API anatiny sy ny API ivelany.
- API Serverless Architecture
Ireo vokatra ireo dia manampy ny mpamorona fampiharana finday amin'ny famolavolana, fananganana, famoahana ary fampiantranoana API miaraka amin'ny fanampian'ny fotodrafitrasa mpizara mifototra amin'ny rahona.
- API-Platform
Ity dia iray amin'ireo rafitra PHP open-source izay mety amin'ny fampivoarana API web.
- Auth0
Izy io dia vahaolana fitantanana ny maha-izy azy ampiasaina hanamarinana sy hanomezana alalana ny API.
- ClearBlade
Izy io dia mpamatsy fitantanana API amin'ny fampidirana ny teknolojia IoT amin'ny dinganao.
- GitHub
Ity serivisy fampiantranoana git open-source ity dia ahafahan'ny mpamorona mitantana ny rakitra kaody, misintona fangatahana, fanaraha-maso ny dikan-teny ary fanehoan-kevitra izay zaraina manerana ny vondrona. Izy io koa dia mamela azy ireo hitahiry ny kaody ao amin'ny tahiry manokana.
- Postman
Amin'ny ankapobeny dia rojom-pitaovana API izy io izay manome hery ny mpamorona hampandeha, hizaha toetra, handrakitra ary hanombana ny fahombiazan'ny API.
- miavonavona
Izy io dia rafitra open-source izay ampiasaina amin'ny rindrambaiko fampandrosoana API. Ireo teknolojia goavam-be toa an'i GettyImages sy Microsoft dia mampiasa Swagger. Na dia feno API aza izao tontolo izao, dia mbola misy banga lehibe amin'ny fampiasana ny tombony amin'ny teknolojia API. Na dia manao tsio-drivotra aza ny API sasany amin'ny fampiharana, ny hafa kosa mamadika izany ho nofy ratsy.
Toetra tsy maintsy ananana amin'ny API mahomby
- Vanim-potoana fanovana na Fikarohana araka ny fepetra
Ny endri-javatra API lehibe indrindra tokony ananan'ny fampiharana dia ny mari-pamantarana fanovana/Karoka araka ny fepetra. Ny API dia tokony hamela ny mpampiasa hikaroka angona mifototra amin'ny fepetra samihafa, toy ny daty. Izany dia satria ny fanovana (fanavaozana, fanitsiana ary fafao) no heverintsika taorian'ny fampifanarahana ny angona voalohany.
- Paging
Imbetsaka, mitranga fa tsy te hahita ny angon-drakitra feno niova isika, fa ny fijery fotsiny. Amin'ny toe-javatra toy izany, ny API dia tokony ho afaka mamaritra hoe ohatrinona ny angon-drakitra aseho amin'ny fotoana iray ary amin'ny firy. Tokony hampahafantatra ny mpampiasa farany momba ny no. ny pejy misy angona sisa.
- manavaka
Mba hahazoana antoka fa ny mpampiasa farany dia mahazo ny pejin'ny angon-drakitra tsirairay, ny API dia tokony hanome hery ny mpampiasa handamina angona araka ny fotoana fanovana na fepetra hafa.
- JSON Support na REST
Na dia tsy voatery aza dia tsara ny mihevitra ny API-nao ho RESTful (na manome fanohanana JSON(REST)) ho an'ny fampandrosoana API mahomby. Ny REST API dia tsy misy fanjakana, maivana ary mamela anao hanandrana indray ny fampidinana fampiharana finday raha toa ka tsy mahomby izany. Tena sarotra izany raha ny SOAP. Ankoatr'izay, ny syntax an'i JSON dia mitovy amin'ny an'ny ankamaroan'ny fiteny fandaharana, izay mahatonga azy ho mora amin'ny mpamorona fampiharana finday hamakivaky azy amin'ny fiteny hafa.
- Fanomezana alalana amin'ny OAuth
Ilaina indray ny manome alalana amin'ny alalan'ny OAuth ny interface programan'ny fampiharana anao satria haingana kokoa noho ny fomba hafa mila manindry bokotra fotsiny ianao dia vita izany.
Raha fintinina, ny fotoana fanodinana dia tokony ho faran'izay kely indrindra, tsara ny fotoana famaliana, ary avo lenta ny fiarovana. Zava-dehibe indrindra ny manao ezaka amin'ny fomba fanao tsara indrindra amin'ny fampivoarana ny API amin'ny fiarovana ny fampiharana anao, raha ny marina, mifandraika amin'ny angon-drakitra.
Terminologie an'ny API
- Key API - Rehefa misy fangatahana fanamarinana API amin'ny alàlan'ny paramètre ary fantaro ny mpangataka. Ary ny kaody nahazo alalana dia niditra tao amin'ny fanalahidin'ny fangatahana ary lazaina fa API KEY.
- Endpoint - Rehefa mifandray amin'ny rafitra hafa ny API avy amin'ny rafitra iray, dia fantatra amin'ny anarana hoe endpoint ny faran'ny fantsona fifandraisana.
- JSON - Ny zavatra JSON na Javascript dia ampiasaina ho endrika angon-drakitra ampiasaina amin'ny mari-pamantarana fangatahana API sy vatana valiny.
- GET - Mampiasa fomba HTTP an'ny API hahazoana loharano
- POST - Ny fomba HTTP RESTful API amin'ny fananganana loharano.
- OAuth - Rafitra fanomezan-dàlana manara-penitra izay manome fidirana avy amin'ny sisin'ny mpampiasa nefa tsy mizara fahazoan-dàlana.
- REST - Ny fandaharana izay manatsara ny fahombiazan'ny fifandraisana eo amin'ireo fitaovana / rafitra roa. Ny REST dia mizara ny angona tokana ilaina fa tsy ny angona feno. Ireo rafitra ampiharina amin'ity maritrano ity dia lazaina fa rafitra 'RESTful', ary ny ohatra tena mavesa-danja indrindra amin'ny rafitra RESTful dia ny World Wide Web.
- SOAP - SOAP na Simple Object Access Protocol dia protocole fandefasana hafatra amin'ny fizarana vaovao voarafitra amin'ny fanatanterahana ny serivisy tranonkala amin'ny tambajotra solosaina.
- Latency - Izy io dia faritana ho ny totalin'ny fotoana lanin'ny fizotry ny fampandrosoana API manomboka amin'ny fangatahana mankany amin'ny valiny.
- Famerana ny tahan'ny - midika izany fa mametra ny isan'ny fangatahana azon'ny mpampiasa atao amin'ny API isaky ny mandeha.
Fomba fanao tsara indrindra amin'ny fananganana API marina
- Ampiasao Throttling
App Throttling dia fomba fanao tsara hodinihina amin'ny famerenana ny fivezivezen'ny fifamoivoizana, ny backup API ary ny fiarovana azy amin'ny fanafihana DoS (Denial of Service).
- Hevero ho Enforcer ny vavahadin-tseraseranao
Rehefa manangana fitsipika mifehy, fampiharana ny lakilen'ny API, na OAuth, dia tsy maintsy raisina ho toy ny teboka fampiharana ny vavahadin'ny API. Tokony horaisina ho toy ny polisy izay mamela ny mpampiasa marina ihany no mahazo ny angon-drakitra. Tokony hanome hery anao hanafenana ny hafatra na hanova ny fampahafantarana tsiambaratelo izy io, ary amin'izay dia hamakafaka sy hitantana ny fomba ampiasana ny API-nao.
- Avelao ny fomba HTTP override
Satria ny proxy sasany dia tsy manohana afa-tsy fomba GET sy POST, mila avelanao ny API RESTful anao hanilika ny fomba HTTP. Mba hanaovana izany, ampiasao ny lohatenin'ny HTTP mahazatra X-HTTP-Method-Override.
- Tombanana ny API sy ny fotodrafitrasa
Amin'izao fotoana izao, azo atao ny maka ny famakafakana amin'ny fotoana tena izy, fa ahoana kosa raha toa ny mpizara API dia ahiana ho manana fitadidiana mitete, manondraka CPU, na olana hafa toy izany? Mba handinihana ny toe-javatra toy izany dia tsy azonao atao ny mitazona ny developer iray. Na izany aza, afaka manao izany mora foana ianao amin'ny alàlan'ny fampiasana fitaovana maro eny an-tsena, toy ny AWS cloud watch.
- Miantoka ny fiarovana
Tsy maintsy miantoka ianao fa ny teknolojia API dia azo antoka fa tsy amin'ny vidin'ny maha-mpampiasa azy. Raha misy mpampiasa mandany mihoatra ny 5 minitra amin'ny fanamarinana dia midika izany fa ny API-nao dia lavitra ny mpampiasa. Azonao atao ny mampiasa fanamarinana mifototra amin'ny marika mba hahazoana antoka ny API anao.
- Documentation
Farany fa tsy ny kely indrindra, dia mahasoa ny mamorona antontan-taratasy midadasika ho an'ny API ho an'ny fampiharana finday izay mamela ny mpamorona fampiharana finday hafa hahatakatra mora foana ny dingana manontolo sy hampiasa ny fampahalalana mba hanomezana traikefa mpampiasa tsara kokoa. Raha lazaina amin'ny teny hafa, ny antontan-taratasy API tsara amin'ny dingan'ny fampivoarana API mahomby dia hampihena ny fotoana hanatanterahana ny tetikasa, ny vidin'ny tetikasa ary hampitombo ny fahombiazan'ny teknolojia API.