He aha te API me nga mea hei whakaaro mo te hanga API?
Ko te API (Atanga Papatono Tono) he huinga tohutohu, paerewa, whakaritenga ranei e taea ai e tetahi rorohiko, taupānga ranei te whakamahi i nga ahuatanga, ratonga ranei o tetahi atu taupānga, papaaho, taputapu ranei mo nga ratonga pai ake. Hei poto, he mea ka taea e nga taupānga te whakawhitiwhiti korero tetahi ki tetahi.
Ko te API te turanga o nga taupānga katoa e pa ana ki nga raraunga ka taea ranei te whakawhitiwhiti korero i waenga i nga hua e rua, ratonga ranei. Ka whakamanahia he tono Waea, he papaahi ranei ki te tiri i ana raraunga ki etahi atu taupānga/turanga me te whakangawari i te wheako kaiwhakamahi me te kore e uru ki nga kaihanga.
I tua atu, ka whakakorehia e nga API te hiahia ki te hanga i tetahi papaapapa rite, rorohiko ranei mai i te wahanga. Ka taea e koe te whakamahi i tetahi o naianei, i tetahi atu papaaho, taupānga ranei. Na enei take, ko te tukanga whanaketanga API he arotahi mo nga kaihanga taupānga me nga kaiwhakahaere kamupene.
Mahi o API
Ki te mea kua whakatuwherahia e koe etahi taupānga XYZ, paetukutuku ranei hei tuhi i tetahi rerenga. I whakakiia e koe te puka, i whakauruhia nga wa wehe me te taenga mai, te taone, nga korero rererangi, me etahi atu korero e tika ana, ka tukuna. I roto i te hautanga o te hēkona, ka puta he rarangi rererangi i runga i te mata me te utu, nga wa, te waatea o nga nohoanga, me etahi atu korero. Me pehea e tupu ai tenei?
Hei whakarato i nga raraunga tino kaha, i tukuna e te papa he tono ki te paetukutuku a te kamupene rererangi kia uru atu ki ta raatau paparangi raraunga me te tiki raraunga e tika ana ma te atanga kaupapa tono. I whakautu te paetukutuku me nga raraunga i tukuna e te API Integration ki te papaahi me te whakaaturanga i runga i te mata.
I konei, ko te tono tono/turanga rererangi me te paetukutuku a te kamupene rererangi ka noho hei mutunga ko te API te takawaenga ki te whakamaarama i nga mahi tiritiri raraunga. I te wa e korero ana mo te whakawhitiwhiti i nga tohu mutunga, ka mahi te API i nga huarahi e rua, ara, REST(Whakawhiti Whenua Whakaatu) me SOAP(Kawa Whakaaetanga Ahanoa Maama).
Ahakoa nga tikanga e rua ka whai hua whai hua, a kamupene whanaketanga taupānga pūkoro he pai ake te REST i te SOAP i te mea he taumaha nga API SOAP me te whakawhirinaki ki te papa.
Kia mohio ai koe ki te huringa ora API me te mohio me pehea te mahi a te API, whakapā atu ki o maatau tohunga i tenei ra!
Nga Utauta mo te Whakawhanake i te API
Ahakoa he maha nga taputapu hoahoa API me nga hangarau kua whakauruhia ki roto i te tukanga o te hanga API, ko nga hangarau whanaketanga API rongonui me nga taputapu mo te whakawhanake API mo nga kaihanga ko:
- Apigee
Ko te kaiwhakarato whakahaere API a Google e awhina ana i nga kaiwhakawhanake me nga kaipakihi ki te wikitoria i te huringa mamati ma te whakatu ano i te huarahi Whakauru API.
- APIMatic me API Transformer
Koinei etahi atu taputapu rongonui mo te whanaketanga API. Ka whakaekea e ratou nga taputapu whakangao aunoa hei hanga i nga SDK-kounga teitei me nga tohu waehere mai i nga whakatakotoranga API-motuhake me te huri ki etahi atu hanganga tohu, penei i te RAML, API Blueprint, etc.
- API Pūtaiao
Ko tenei taputapu ka whakamahia tuatahi mo te arotake i nga mahi o nga API o roto me nga API o waho.
- API Tūmau Hanganga Kore
Ko enei hua ka awhina i nga kaiwhakawhanake taupānga pūkoro ki te hoahoa, ki te hanga, ki te whakaputa, ki te manaaki i nga API me te awhina o nga hanganga tūmau-kapua.
- API-Turanga
Koinei tetahi o nga anga PHP tuwhera-puna e pai ana mo te whanaketanga API tukutuku.
- Tuhi0
He otinga whakahaere tuakiri hei whakamotuhēhē me te whakamana i ngā API.
- Maamaa
He kaiwhakarato whakahaere API mo te awhi i te hangarau IoT ki to mahi.
- GitHub
Ko tenei ratonga manaaki git puna tuwhera ka taea e nga kaihanga te whakahaere i nga konae waehere, tono tono, mana putanga, me nga korero ka tohatoha puta noa i te roopu. Ka tukuna ano e ratou te tiaki i o raatau waehere ki roto i nga whare putunga motuhake.
- Kai-pou
Ko te tikanga he taputapu taputapu API e whakamana ana i nga kaiwhakawhanake ki te whakahaere, ki te whakamatautau, ki te tuhi, ki te arotake i nga mahi o a raatau API.
- Reweti
He anga tuwhera-puna e whakamahia ana mo te rorohiko whanaketanga API. Ko nga roroa hangarau nui penei i a GettyImages me Microsoft e whakamahi ana i te Swagger. Ahakoa kua ki tonu te ao i nga API, he waahi nui tonu mo te whakamahi i nga painga o te hangarau API. Ahakoa ko etahi API ka ngawari te whakauru ki te taupānga, ko etahi ka huri hei moemoea.
Ko nga ahuatanga o te API pai me whai
- Nga tohu waahi whakarereke, Rapu ranei ma nga paearu
Ko te waahanga API matua me mau i tetahi taupānga ko nga tohu wa whakarereke/Rapu ma nga paearu. Ma te API e tuku nga kaiwhakamahi ki te rapu raraunga i runga i nga paearu rereke, penei i te ra. Na te mea ko nga huringa (whakahou, whakatika me te muku) ka whakaarohia e matou i muri tonu i te tukutahitanga raraunga tuatahi.
- Paari
He maha nga wa, kaore matou e hiahia ki te kite i te whakarereketanga o nga raraunga katoa, engari he tirohanga noa. I roto i tenei ahuatanga, me kaha te API ki te whakatau i te nui o nga raraunga hei whakaatu i te waa kotahi me te aha te auau. Me whakamohio ano ki te kaiwhakamahi mutunga mo te kore. o nga wharangi o nga raraunga e toe ana.
- Kōmaka
Hei whakarite kia whiwhi te kaiwhakamahi mutunga i nga wharangi raraunga katoa, ma te API e whakamana nga kaiwhakamahi ki te whakariterite raraunga i runga i te waa whakarereke, etahi atu ahuatanga ranei.
- Tautoko JSON, REST ranei
Ahakoa ehara i te mea here, he pai ki te whakaaro he RESTful to API (te whakarato tautoko JSON(REST)) mo te whanaketanga API whai hua. Ko nga REST API he koretake, he marama-taimaha, ka tuku kia ngana ano koe ki te tuku tuku tono waea pūkoro mena ka rahua. He tino uaua tenei mo te SOAP. I tua atu, he rite te wetereo a JSON ki te nuinga o nga reo hootaka, na te mea he ngawari ki te kaiwhakawhanake taupānga waea ki te wetewete ki tetahi atu reo.
- Whakamanatanga ma OAuth
He mea tika ano kia whakamanahia to atanga papatono tono ma OAuth i te mea he tere ake i etahi atu tikanga me paato noa i te paatene ka oti.
I roto i te poto, me iti te wa tukatuka, te wa whakautu pai, me te taumata haumaru. He mea tino nui ki te whakapau kaha ki nga mahi pai mo te whakawhanaketanga API mo te whakapumau i to tono, i muri i nga mea katoa, he maha nga raraunga.
Nga kupu o te API
- Kī API - Ina tono te tirotiro API ma te tawhā me te mohio ki te kaitono. Na ka tukuna te waehere whaimana ki roto i te kii tono ka kiia he KINI API.
- Wāhi Whakamutunga - Ina mahi tahi te API mai i tetahi punaha me tetahi atu punaha, ka mohiotia tetahi pito o te hongere korero he tohu mutunga.
- JSON - Ko nga mea JSON, Javascript ranei ka whakamahia hei whakatakotoranga raraunga mo nga taapiri tono API me te tinana whakautu.
- GET – Te whakamahi i te tikanga HTTP a API mo te tiki rauemi
- POST – Ko te tikanga HTTP a te RESTful API mo te hanga rauemi.
- OAuth – He anga whakamanatanga paerewa e tuku urunga mai i te taha o te kaiwhakamahi me te kore e tiritiri i nga tohu.
- REST - Ko te kaupapa e whakanui ana i te pai o te whakawhitiwhiti korero i waenga i nga taputapu / punaha e rua. Ka tohatohahia e REST nga raraunga anake e hiahiatia ana ehara i nga raraunga katoa. Ko nga punaha e whakamanahia ana ki tenei hoahoanga e kiia ana he punaha 'RESTful', a ko te tauira tino nui o nga punaha RESTful ko te Tukutuku Ao Whānui.
- SOAP – SOAP he Kawa Whakaaetanga Ahanoa Maamaa ranei he kawa karere mo te tiritiri i nga korero hangahanga mo te whakahaere i nga ratonga tukutuku i roto i nga whatunga rorohiko.
- Latency - Kua tautuhia ko te wa katoa i tangohia e te tukanga whanaketanga API mai i te tono ki te whakautu.
- Te Whakaiti Reiti – ko te tikanga he aukati i te maha o nga tono ka taea e te kaiwhakamahi te pa ki tetahi API mo ia wa.
Nga Mahi Pai mo te Hanga i te API Tika
- Whakamahia te Whakatere
He mahi pai a App Throttling hei whakaaro mo te huri i te waipuke o nga waka, nga API taapiri, me te tiaki mai i nga whakaeke DoS (Denial of Service).
- Whakaarohia to kuaha API hei Kaipupuri
I a koe e whakarite ana i nga ture tarai, te whakamahi i nga taviri API, te OAuth ranei, me whakaaro te kuaha API hei waahi uruhi. Me kii he pirihimana ka taea e nga kaiwhakamahi tika anake te uru ki nga raraunga. Me whakamana koe ki te whakamuna i te karere, ki te whakatika ranei i nga korero matatapu, na reira, ka tātari me te whakahaere me pehea te whakamahi i to API.
- Whakaaetia te tikanga HTTP whakakapi
I te mea kei te tautoko noa etahi o nga kaiwawao i nga tikanga GET me POST, me tuku to API RESTful ki te whakakore i te tikanga HTTP. Mo te mahi pera, whakamahia te ritenga HTTP Pane X-HTTP-Method-Verride.
- Te arotake i nga API me nga hanganga
I tenei wa, ka taea te tango i nga tātaritanga-a-waa, engari ka pewhea mena ka whakapaehia kei te raru te kaimau API, te whakaheke PTM, me era atu take penei? Hei whakaaro ki nga ahuatanga penei, kaore e taea e koe te pupuri i tetahi kaiwhakawhanake. Heoi, ka taea e koe te mahi ngawari ma te whakamahi i nga taputapu maha e waatea ana i te maakete, penei i te maataki kapua AWS.
- Whakaritea te haumarutanga
Me whakarite e koe kei te noho haumaru to hangarau API engari kaua i te utu mo te atawhai-kaiwhakamahi. Mena ka whakapaua e tetahi kaiwhakamahi neke atu i te 5 meneti mo te whakamotuhēhēnga, ko te tikanga kei tawhiti atu to API ki te hoa-kaiwhakamahi. Ka taea e koe te whakamahi i te motuhēhēnga tohu tohu kia noho haumaru ai to API.
- Documentation
Ko te mea whakamutunga engari ehara i te mea iti rawa, he pai ki te hanga tuhinga whanui mo te API mo nga taupānga waea e taea ai e etahi atu kaiwhakawhanake taupānga pūkoro te maarama ki te katoa o nga mahi me te whakamahi i nga korero mo te tuku wheako kaiwhakamahi pai ake. I etahi atu kupu, ko nga tuhinga API pai i roto i te tukanga o te whakawhanaketanga API whai hua ka iti ake te wa whakatinana kaupapa, te utu kaupapa me te whakanui i te kaha o te hangarau API.