A-Gwida-Kompleta-għall-Iżvilupp-API-

X'inhu l-API u l-Affarijiet li għandek tikkonsidra meta tiżviluppa API?

API (Application Programming Interface) hija sett ta' struzzjonijiet, standards jew rekwiżiti li jippermettu li softwer jew app jimpjega karatteristiċi jew servizzi ta' app, pjattaforma jew apparat ieħor għal servizzi aħjar. Fil-qosor, hija xi ħaġa li tħalli l-apps jikkomunikaw bejniethom.

 

API hija l-bażi tal-apps kollha li jittrattaw id-dejta jew jippermettu komunikazzjoni bejn żewġ prodotti jew servizzi. Jagħti s-setgħa lil applikazzjoni jew pjattaforma mobbli biex taqsam id-dejta tagħha ma' apps/pjattaformi oħra u tħaffef l-esperjenza tal-utent mingħajr ma tinvolvi l-iżviluppaturi. 

Barra minn hekk, l-APIs ineħħu l-ħtieġa li tinħoloq pjattaforma jew softwer komparabbli mill-bidu. Tista 'tutilizza l-pjattaforma jew app attwali waħda jew oħra. Minħabba dawn ir-raġunijiet, il-proċess tal-iżvilupp tal-API huwa fokus kemm għall-iżviluppaturi tal-apps kif ukoll għall-eżekuttivi tal-kumpanija.

 

Ħidma tal-API

Ejja ngħidu li ftaħt xi app XYZ jew websajt biex tibbukkja titjira. Imliet il-formola, inkludiet il-ħinijiet tat-tluq u tal-wasla, il-belt, l-informazzjoni dwar it-titjira, u informazzjoni oħra meħtieġa, imbagħad issottomettitha. Fi ftit sekondi, lista ta’ titjiriet tidher fuq l-iskrin flimkien mal-prezz, il-ħinijiet, id-disponibbiltà tas-sedili, u dettalji oħra. Kif jiġri dan fil-fatt?

 

Biex tipprovdi data daqshekk stretti, il-pjattaforma bagħtet talba lill-websajt tal-linja tal-ajru biex taċċessa d-database tagħhom u tikseb data rilevanti permezz tal-interface tal-programm tal-applikazzjoni. Il-websajt wieġbet bid-dejta li API Integration wassal lill-pjattaforma u l-pjattaforma wrietha fuq l-iskrin.

 

Hawnhekk, l-app/pjattaforma tal-prenotazzjoni tat-titjiriet u l-websajt tal-linja tal-ajru jaġixxu bħala endpoints filwaqt li l-API hija l-intermedjarju li jissimplifika l-proċess tal-kondiviżjoni tad-dejta. Meta titkellem dwar il-komunikazzjoni tal-endpoints, l-API taħdem f'żewġ modi, jiġifieri, REST (Trasferiment tal-Istat Rappreżentattiv) u SOAP (Protokoll Sempliċi ta 'Aċċess għall-Oġġetti).

 

Għalkemm iż-żewġ metodi jġibu riżultati effettivi, a kumpanija għall-iżvilupp tal-app mobbli jippreferi REST fuq SAPUN peress li l-APIs SOAP huma tqal u jiddependu mill-pjattaforma.

 

Biex tifhem iċ-ċiklu tal-ħajja tal-API u l-għarfien jaħdem l-API fid-dettall, ikkuntattja lill-esperti tagħna llum!

 

Għodda għall-Iżvilupp ta' API

Filwaqt li hemm għadd kbir ta’ għodod u teknoloġiji tad-disinn tal-API mgħammra fil-proċess tal-ħolqien ta’ API, it-teknoloġiji u l-għodod popolari tal-iżvilupp tal-API għall-iżvilupp tal-APIs għall-iżviluppaturi huma:

 

  • Apigee

Huwa l-fornitur tal-ġestjoni tal-API ta' Google li jassisti lill-iżviluppaturi u lill-intraprendituri biex jirbħu fit-trasformazzjoni diġitali billi jerġa' jistabbilixxi approċċ tal-Integrazzjoni tal-API.

 

  • APIMatic u API Transformer

Dawn huma għodod oħra popolari għall-iżvilupp tal-API. Huma joffru għodod sofistikati ta 'ġenerazzjoni awtomatika biex jibnu SDKs u snippets tal-kodiċi tal-ogħla kwalità minn formati speċifiċi għall-API u jittrasformawhom f'formazzjonijiet oħra ta' speċifikazzjoni, bħal RAML, API Blueprint, eċċ.

 

  • Xjenza API 

Din l-għodda tintuża primarjament għall-evalwazzjoni tal-prestazzjoni kemm tal-APIs interni kif ukoll tal-APIs esterni.

 

  • Arkitettura API Serverless 

Dawn il-prodotti jassistu lill-iżviluppaturi tal-apps mobbli fit-tfassil, il-bini, il-pubblikazzjoni u l-hosting tal-APIs bl-għajnuna tal-infrastruttura tas-server ibbażata fuq il-cloud.

 

  • API-Pjattaforma

Dan huwa wieħed mill-oqfsa PHP open-source li huwa adattat għall-iżvilupp tal-API tal-web.

 

  • Awth0

Hija soluzzjoni għall-immaniġġjar tal-identità użata biex tawtentika u tawtorizza l-APIs.

 

  • ClearBlade

Huwa fornitur tal-ġestjoni tal-API biex iħaddan it-teknoloġija tal-IoT fil-proċess tiegħek.

 

  • GitHub

Dan is-servizz ta 'hosting ta' repożitorju git ta 'sors miftuħ iħalli lill-iżviluppaturi jimmaniġġjaw fajls tal-kodiċi, talbiet ta' ġibda, kontroll tal-verżjoni, u kummenti li huma mqassma fil-grupp. Ħallihom ukoll isalvaw il-kodiċi tagħhom f'repożitorji privati.

 

  • Postier

Bażikament hija toolchain API li tagħti s-setgħa lill-iżviluppaturi biex imexxu, jittestjaw, jiddokumentaw u jevalwaw il-prestazzjoni tal-API tagħhom.

 

  • swagger

Huwa qafas ta 'sors miftuħ li jintuża għal softwer għall-iżvilupp tal-API. Ġganti kbar tat-teknoloġija bħal GettyImages u Microsoft jużaw Swagger. Għalkemm id-dinja hija mimlija APIs, għad hemm vojt kbir fl-użu tal-vantaġġi tat-teknoloġija API. Filwaqt li xi APIs jagħmlu l-integrazzjoni mal-app faċli, oħrajn jibdluha f'ħmar il-lejl.

 

Karatteristiċi Must-Have ta 'API Effiċjenti

  • Timbri tal-modifika jew Fittex skond il-kriterji

L-ewwel karatteristika tal-API li app għandu jkollha hija l-Timestamps tal-Modifikazzjoni/Tfittxija skont il-kriterji. API għandha tħalli lill-utenti jfittxu dejta bbażata fuq kriterji differenti, bħal data. Dan għaliex huma l-bidliet (aġġornament, editjar u ħassar) li nikkunsidraw eżatt wara l-ewwel sinkronizzazzjoni tad-data inizjali.

 

  • Pejġing 

Ħafna drabi, jiġri li ma rridux naraw id-dejta sħiħa mibdula, iżda biss ħarsa tagħha. F'xenarju bħal dan, l-API għandha tkun kapaċi tiddetermina kemm dejta għandha turi f'daqqa u b'liema frekwenza. Għandha wkoll tinforma lill-utent aħħari dwar in-nru. tal-paġni tad-dejta li fadal.

 

  • Issortjar

Biex jiġi żgurat li l-utent finali jirċievi l-paġni kollha tad-dejta waħda waħda, l-API għandha tagħti s-setgħa lill-utenti biex issolvi d-dejta skont il-ħin tal-modifika jew xi kundizzjoni oħra.

 

  • JSON Appoġġ jew REST

Għalkemm mhux obbligatorju, huwa tajjeb li tikkunsidra l-API tiegħek bħala RESTful (jew tipprovdi appoġġ JSON (REST)) għal żvilupp effettiv tal-API. L-APIs REST huma mingħajr stat, b'piż ħafif, u jħalluk terġa' tipprova l-proċess tal-app tal-mowbajl ittella' jekk ifalli. Dan huwa pjuttost iebsa fil-każ tas-SAPUN. Barra minn hekk, is-sintassi ta 'JSON tixbah lil dik tal-biċċa l-kbira tal-lingwi ta' programmar, li jagħmilha faċli għal żviluppatur ta 'app mobbli biex jparsaha fi kwalunkwe lingwa oħra.

 

  • Awtorizzazzjoni permezz OAuth

Huwa għal darb'oħra meħtieġ li l-interface tal-programm tal-applikazzjoni tiegħek jawtorizza permezz ta' OAuth peress li huwa aktar mgħaġġel minn metodi oħra li għandek bżonn biss li tikklikkja fuq buttuna u lest.

 

Fil-qosor, il-ħin tal-ipproċessar għandu jkun minimu, ħin ta 'rispons tajjeb, u livell ta' sigurtà għoli. Huwa ta 'importanza kbira li tagħmel sforzi fl-aħjar prattiki tal-iżvilupp tal-API biex tiżgura l-applikazzjoni tiegħek, wara kollox, tittratta ma' munzell ta 'dejta.

 

Terminoloġiji tal-API

 

  1. Ċavetta API - Meta titlob verifika API permezz ta 'parametru u tifhem lil min jagħmel it-talba. U l-kodiċi awtorizzat għadda fiċ-ċavetta tat-talba u jingħad li huwa API KEY.
  2. Endpoint - Meta l-API minn sistema waħda jinteraġixxi ma 'sistema oħra, it-tarf wieħed tal-kanal ta' komunikazzjoni huwa magħruf bħala endpoint.
  3. JSON – Oġġetti JSON jew Javascript jintużaw biex ikunu format tad-dejta użat għall-parametri tat-talba tal-APIs u l-korp tar-rispons. 
  4. GET – L-użu tal-metodu HTTP tal-API biex tikseb ir-riżorsi
  5. POST - Huwa l-metodu HTTP tal-API RESTful għall-bini tar-riżorsi. 
  6. OAuth – Huwa qafas ta’ awtorizzazzjoni standard li jagħti aċċess min-naħa tal-utent mingħajr ma jaqsam l-ebda kredenzjali. 
  7. REST - L-ipprogrammar li jsaħħaħ l-effiċjenza tal-komunikazzjoni bejn iż-żewġ apparati/sistemi. REST jaqsam l-unika dejta li hija meħtieġa mhux id-dejta sħiħa. Is-sistemi infurzati fuq din l-arkitettura jingħad li huma sistemi 'RESTful', u l-aktar eżempju kbir ta 'sistemi RESTful huwa l-World Wide Web.
  8. SOAP – SOAP jew Simple Object Access Protocol huwa protokoll ta’ messaġġi għall-qsim ta’ informazzjoni strutturata fl-eżekuzzjoni ta’ servizzi tal-web f’netwerks tal-kompjuter.
  9. Latency - Huwa definit bħala l-ħin totali meħud minn proċess ta 'żvilupp API mit-talba għar-rispons.
  10. Limitazzjoni tar-Rata - tfisser li tirrestrinġi n-numru ta 'talbiet li utent jista' jolqot għal API kull darba.

 

L-Aħjar Prattiki għall-Bini tal-API t-Tajba

  • Uża Throttling

App Throttling hija prattika kbira li għandek tikkonsidra biex tirriindirizza l-overflow tat-traffiku, APIs backup, u ssalvagwardjah minn attakki DoS (Denial of Service).

 

  • Ikkunsidra l-gateway tal-API tiegħek bħala Enforcer

Waqt it-twaqqif ta' regoli ta' throttling, applikazzjoni ta' ċwievet API, jew OAuth, il-portal tal-API għandu jitqies bħala l-punt ta' infurzar. Għandu jittieħed bħala pulizija li jħalli biss lill-utenti t-tajbin ikollhom aċċess għad-dejta. Għandu jagħtik is-setgħa li tikkodifika l-messaġġ jew teditja informazzjoni kunfidenzjali, u b'hekk, tanalizza u timmaniġġja kif qed tintuża l-API tiegħek.

 

  • Ħalli l-metodu HTTP overriding

Peress li xi prokuri jappoġġjaw biss il-metodi GET u POST, trid tħalli l-API RESTful tiegħek tegħleb il-metodu HTTP. Biex tagħmel dan, uża l-HTTP Header X-HTTP-Method-Override tad-dwana.

 

  • Evalwa l-APIs u l-infrastruttura

Fil-ħin attwali, analiżi f'ħin reali huwa possibbli li tinkiseb, imma x'jiġri jekk is-server API huwa suspettat li jkollu tnixxijiet tal-memorja, tbattal CPU, jew kwistjonijiet oħra bħal dawn? Biex tikkunsidra sitwazzjonijiet bħal dawn, ma tistax iżżomm żviluppatur fid-dmir. Madankollu, tista 'twettaq dan faċilment billi tuża bosta għodod disponibbli fis-suq, bħall-AWS cloud watch.

 

  • Tiżgura s-sigurtà

Int trid tiżgura li t-teknoloġija API tiegħek hija sigura iżda mhux għall-ispiża tal-faċilità għall-utent. Jekk xi utent iqatta' aktar minn 5 minuti fuq l-awtentikazzjoni allura dan ifisser li l-API tiegħek hija 'l bogħod milli tkun faċli għall-utent. Tista' tuża awtentikazzjoni bbażata fuq tokens biex tagħmel l-API tiegħek sigura.

 

  • dokumentazzjoni

Fl-aħħar iżda mhux l-inqas, huwa ta 'profitt li tinħoloq dokumentazzjoni estensiva għal API għal apps mobbli li tħalli żviluppaturi oħra ta' app mobbli faċilment jifhmu l-proċess kollu u jutilizzaw l-informazzjoni biex joffru esperjenza aħjar għall-utent. Fi kliem ieħor, dokumentazzjoni tajba tal-API fil-proċess tal-iżvilupp effettiv tal-API se tnaqqas il-ħin tal-implimentazzjoni tal-proġett, l-ispiża tal-proġett u tagħti spinta lill-effiċjenza tat-teknoloġija tal-API.