He aha nga Ratonga Tukutuku Ataahua

Kupu Whakataki

I roto i ta maatau tuhinga o mua kua korerohia he aha te API. He rereke nga momo waea API hei tauira, te Kawa Whakaaetanga Ahanoa Maamaa (SOAP), Waea Tikanga Mamao (RPC) me te Whakawhiti Whenua Representational (REST). Ko enei waea API katoa he kaupapa kotahi, ara ki te whakawhiti i nga raraunga i waenga i nga punaha e rua, neke atu ranei. I roto i tenei tuhinga ka tirotirohia e matou nga Ratonga Tukutuku Whakahoki.

He aha te REST

Ka rite ki te korero i mua ake nei, ko te REST e tu ana mo te Whakawhitinga Whenua Representational State. He huarahi ngawari ki te tuku me te whiwhi raraunga i waenga i te kaihoko me te tūmau. Kaore e hiahiatia he rorohiko, he paerewa ranei hei whakawhiti raraunga. He hanganga kua tautuhia hei mahi i te karanga API. Me whakamahi noa nga kaiwhakawhanake i te huarahi kua tohua ka tukuna o raatau raraunga hei utu JSON.

Ratonga Tukutuku Ataahua

Huanga o nga Ratonga Tukutuku Ataahua

E ono nga here/huanga e whai ana te ratonga tukutuku RESTful:

  1. Kiritaki-Tumaumau: He mea tino nui o REST API. Ko te REST API e whai ana i te hoahoanga a te kiritaki-tūmau, me wehe enei e rua. Ko te tikanga e kore e taea e te tūmau me te kiritaki te tūmau kotahi. Mena he rite tonu, ka whiwhi koe i te hapa CORS.
  2. Karekau: I roto i te REST, ka kiia nga waea katoa he waea hou, a, ko nga ahuatanga waea o mua e kore e whai hua ki te waea hou. No reira i ia waeatanga, me mau tonu nga whakamotuhēhēnga katoa e tika ana me etahi atu korero.
  3. Pouaka: Ko te REST API e whakatenatena ana i te kaitirotiro me te mahi keteroki tūmau hei whakarei ake i tana tere tukatuka.
  4. Atanga Taurite: Ko te atanga i waenga i te Kiritaki me te Tūmau ka noho rite tonu, no reira ko nga huringa i tetahi taha e kore e pa ki te mahi API. Ka awhina tenei ki te whakawhanake i te punaha Kiritaki me te Tūmau takitahi.
  5. Pūnaha Paparanga: Ka taea e REST te whakamahi i te hanganga paparanga i te taha o te tūmau, ara, ka taea e koe te whai raraunga i runga i nga tūmau rereke, i te whakamotuhēhēnga i runga i te tūmau rerekē i te API i runga i te tūmau rerekē. E kore rawa te kiritaki e mohio kei te whiwhi raraunga mai i te kaimau.
  6. Waehere i runga i te tono: He waahanga taapiri o te REST API ka taea e te tūmau te tuku waehere ka taea ki te kiritaki ka taea te whakahaere tika i te waa oma.

Nga Tikanga i roto i nga Ratonga Tukutuku Ataahua

Ma te whakamahi i nga ratonga paetukutuku Restful, ka taea e matou enei mahinga e wha:

  1. TIKI: Ka whakamahia tenei tikanga ki te tiki rarangi raraunga mai i te tūmau.
  2. POST: Ka whakamahia tenei tikanga ki te whakairi/te hanga rekoata hou ki te tūmau.
  3. PUT: Ka whakamahia tenei tikanga ki te whakahou i tetahi rekoata o te tūmau.
  4. MUKU: Ka whakamahia tenei tikanga ki te whakakore i tetahi rekoata i te taha o te tūmau.

Tuhipoka: Ko te waea noa ki te tikanga i runga ake nei kaore e kii ka mahia nga mahi kia oti ra ano enei mahi ki te taha o te tūmau.

Nga Painga o nga Ratonga Tukutuku Ataahua

E whai ake nei nga painga nui o te RESTful API:

  • He ngawari ake, he ngawari hoki ki te whakatinana
  • Ka tautokohia te maha atu o nga momo whakatakotoranga raraunga hei tauira JSON, XML, YAML, aha atu.
  • He tere ake, he pai ake te mahi

Nga ngoikoretanga o nga Ratonga Tukutuku Ataahua

Ahakoa he maha nga painga o nga ratonga REST, he maha tonu nga hua i puta:

  • Hei whakatinana i nga paatai ​​e pa ana ki te kawanatanga ka hiahiatia nga Pane REST he mahi poauau
  • Ko nga mahi PUT me DELETE kare e taea te whakamahi ma nga papaahi, i etahi kaitirotiro ranei.

Waiho he tākupu

Whakamahia ai e tenei pae i te Akismet hei whakaiti i te mokowhiti. Akohia te tukatuka o to raraunga korero.