API: He aha ia a no ke aha ia

Hoʻohou hope loa: 25/04/2024

Ua lilo nā API (Application Programming Interface) i mea kumu e ʻae ai i ke kamaʻilio wai ma waena o nā ʻāpana polokalamu like ʻole. Ke hana nei kēia mau mea hana ikaika ma ke ʻano he alahaka e hoʻopili ai i nā noi, nā ʻōnaehana a me nā waihona, e ʻae ana i ka hoʻololi kūpono o ka ʻike a me ka hana.

ʻO nā API nā nā mīkini ʻike ʻole ka mea e hiki ai ke kilokilo o ka ʻenehana hou. E noʻonoʻo i ka app weather ma kāu kelepona. I kēlā me kēia manawa āu e nānā ai i ka wānana o ke aniau, e kamaʻilio ka app me ka ʻōnaehana polokalamu meteorological institute ma o nā API, e loaʻa ana ka ʻikepili hou loa a pololei e hōʻike koke iā ʻoe. ʻO kēia kahi hiʻohiʻona o ke ʻano o nā API maʻalahi i ka hoʻohui ʻana a me ke kahe o ka ʻike ma waena o nā ʻōnaehana like ʻole.

He aha ia he API

Akā he aha ke ʻano o ka huaʻōlelo API? Hōʻike kēia mau acronyms i ka "Application Programming Interface." Maʻaneʻi, pili ka huaʻōlelo "application" i kekahi polokalamu me kahi hana kikoʻī. Hana ʻia ka interface ma ke ʻano he ʻaelike lawelawe ma waena o nā noi ʻelua, e wehewehe ana pehea e kamaʻilio ai kekahi i kekahi me ka hoʻohana ʻana i nā noi a me nā pane. Hāʻawi ka palapala API i ka ʻike kikoʻī e pili ana i ka hana ʻana o nā mea hoʻomohala i kēia mau pilina.

ʻO ka hoʻolālā API

No ka hoʻomaopopo maikaʻi ʻana i ka hana ʻana o nā API, pono e ʻike i kā lākou hoʻolālā. ʻO ka mea maʻamau, wehewehe ʻia ma ke ʻano o mea kūʻai aku a me ke kikowaena. ʻO ka palapala noi e hoʻouna i ka noi i kapa ʻia ʻo ka mea kūʻai aku, ʻoiai ʻo ka mea nāna e hāʻawi i ka pane i ʻike ʻia ʻo ia ke kikowaena. Ma ka laʻana o ka weather app, ʻo ka waihona ʻikepili o ka institute ke kikowaena a ʻo ka polokalamu kelepona ka mea kūʻai aku.

Aia nā ʻano API like ʻole e pili ana i kā lākou hoʻolālā a me ka manawa o ka hana ʻana:

  • API KOPA: Hoʻohana lākou i ka protocol access object a me ka hoʻololi ʻana i nā memo me ka XML.
  • API RPC: Ma muli o nā kelepona kaʻina hana mamao, kahi e hoʻopau ai ka mea kūʻai aku i kahi hana ma ke kikowaena a loaʻa ka hopena.
  • WebSocket API: Hāʻawi lākou i ke kamaʻilio bidirectional ma waena o ka mea kūʻai aku a me ke kikowaena e hoʻohana ana i nā mea JSON e hoʻouna i ka ʻikepili.
  • API hoomaha: ʻO ka mea kaulana loa a maʻalahi ma ka pūnaewele o kēia manawa, kahi e hoʻouna ai ka mea kūʻai aku i nā noi i ke kikowaena a loaʻa ka ʻikepili i ka pane.
Maʻiʻo kūʻokoʻa - Kaomi maanei  Kani Kiʻi no ke kelepona hele

Luʻu hohonu i nā API REST

Ua lilo nā API REST (Representational State Transfer) i ke kūlana de facto i ka hoʻomohala pūnaewele hou. Hoʻokumu ʻia lākou ma kahi hoʻonohonoho o nā hana e like me E LOA, E KAU, E HELE, i hoʻohana ʻia e nā mea kūʻai aku e komo i ka ʻikepili mai ke kikowaena ma luna o ka protocol HTTP. ʻO kahi hiʻohiʻona nui o REST API ko lākou ka ʻole o ka mokuʻāina, ʻo ia hoʻi, ʻaʻole mālama nā kikowaena i ka ʻikepili o ka mea kūʻai aku ma waena o nā noi.

He aha nā REST API e hāʻawi ai

Hāʻawi nā REST API i kekahi mau pono nui:

  1. Hoʻohuiʻia: Hāʻawi lākou i nā noi hou e hoʻohui ʻia me nā ʻōnaehana e kū nei me ka maikaʻi, me ka hoʻohana pono ʻana i nā code i loaʻa.
  2. 'Onoho: Hoʻomaʻamaʻa lākou i ka hoʻolaha wikiwiki ʻana o nā lawelawe hou ma ka ʻae ʻana i nā loli i ka API me ke kākau ʻole ʻana i nā code āpau.
  3. Hoʻolahalaha: Hāʻawi lākou i nā hui i ka manawa kūpono e hoʻokō i nā pono o ka mea kūʻai aku ma nā kahua like ʻole ma o ke komo ʻana i nā ʻikepili kūloko.
  4. Māmā o ka mālama: Hana lākou ma ke ʻano he ʻīpuka ma waena o nā ʻōnaehana, e pale ana i nā loli kūloko mai ka hoʻopili ʻana i nā ʻāpana ʻē aʻe.

ʻO nā ʻano API e like me kā lākou hoʻohana

Ma waho aʻe o ka hoʻolālā ʻana, ua hoʻokaʻawale ʻia nā API e like me kā lākou hoʻohana ʻana:

  • Nā API pilikino: No ka hoʻohana i loko o kahi hui e hoʻohui i nā ʻōnaehana a me nā ʻikepili.
  • Nā API no ka lehulehu: Wehe i ka lehulehu, pono paha lākou i ka ʻae a loaʻa nā koina pili.
  • API hoa: Hiki ke loaʻa wale i nā mea hoʻomohala ʻaoʻao ʻekolu i ʻae ʻia i nā hui pāʻoihana-a-ʻoihana.
  • Nā API hui: Hoʻohui lākou i nā API like ʻole e hoʻoponopono i nā koi ʻōnaehana paʻakikī a i ʻole nā ​​hana.

ʻO ke koʻikoʻi a me ke kuleana o nā helu hope i nā API

ʻO nā wahi pili API ka nā wahi kikoʻī kahi i hoʻouna ʻia ai a loaʻa mai ka ʻike ma waena o nā ʻōnaehana. He mea koʻikoʻi lākou no nā ʻoihana no nā kumu nui ʻelua:

  1. Ka malu: Hiki ke pilikia nā wahi hopena i ka hoʻouka ʻana, no laila pono ka nānā ʻana iā lākou.
  2. Wahi: Hiki i nā wahi hopena kiʻekiʻe ke hana i nā bottlenecks a pili i ka hana ʻōnaehana.
Maʻiʻo kūʻokoʻa - Kaomi maanei  Pehea e hoʻouka ai iā Apple TV ma Android TV

Palekana no nā REST API: Nā hōʻailona hōʻoia a me nā kī API

He mea koʻikoʻi ka palekana i ka hoʻohana ʻana i nā API. ʻElua ala maʻamau e hoʻopaʻa i nā REST API:

  1. Nā hōʻailona hōʻoia: Hōʻoia lākou i ka ʻike o nā mea hoʻohana a me kā lākou mau kuleana komo e kelepona i ka API.
  2. Nā kī API: Hoʻomaopopo lākou i ka noi e hana i ke kelepona a me kāna mau ʻae, e ʻae i ka nānā ʻana i ka hoʻohana ʻana i ka API.

API no ke aha ia?

Pehea e hana ai i kahi API: kahi hana hoʻolālā, hoʻomohala a me nā palapala

Pono ka hana ʻana i kahi API kiʻekiʻe ma muli o ke kaʻina hana pono:

  1. Hoʻolālā API: E wehewehe i nā kikoʻī a hoʻohana i nā hihia ma muli o nā kūlana hoʻomohala o kēia manawa.
  2. Hana ʻia ʻo API: E hoʻomohala i nā prototypes me ka hoʻohana hou ʻana i ke code a hoʻonohonoho iā lākou e like me nā pono.
  3. Ho'āʻo API: Hana i ka hoʻāʻo nui e pale aku i nā hewa a hōʻoia i ka palekana.
  4. Palapala API: Hāʻawi i ke alakaʻi maopopo a piha i mea e maʻalahi ai ka hoʻohana ʻana a me ka hoʻohana ʻana.
  5. Kalepa API: Hoʻopuka i ka API ma nā mākeke kūikawā e hoʻolilo kālā a hiki i nā mea hoʻomohala hou aʻe.

Hoʻāʻo API: E hōʻoia i ka hana a me ka palekana

Pono ka hoʻāʻo ʻana o API e hōʻoia i ka hana kūpono a me ka palekana. Aia kekahi mau hoʻolālā:

  • E hana i nā noi he nui i nā helu hope e loiloi i ka hana.
  • Kākau i nā hoʻokolohua ʻāpana e hōʻoia i ka ʻoihana loiloi a me ka pololei hana.
  • Hoʻohālikelike i nā hoʻouka ʻōnaehana e hoʻāʻo i ka seguridad.

Pehea e kākau ai i nā palapala API kūpono

Pono nā palapala akaka a piha i mea e maʻalahi ai ka hoʻohana ʻana a me ka hoʻokomo ʻana i kahi API. ʻO kekahi mau hana i manaʻo ʻia:

  • E hoʻohana i ka ʻōlelo maʻalahi a oluolu e maopopo.
  • E komo pū code samples e hōʻike i ka hana.
  • E mālama i nā palapala i kēia lā a pololei.
  • E alakaʻi i ke ʻano kākau nā mea hoʻomaka.
  • Uhi i nā mea a pau nā pilikia i hiki i ka API ke hoʻoponopono No nā mea hoʻohana.

API: nā ʻanuʻu e hoʻomaka ai

No ka hoʻomaka ʻana e hoʻohana i kahi API hou, e hahai i kēia mau ʻanuʻu:

  1. kiʻi i hoʻokahi Kiʻi API ka hana ʻana i kahi moʻokāki i hōʻoia ʻia me ka mea hāʻawi.
  2. Hoʻonohonoho a Mea kūʻai aku HTTP API e hana maʻalahi i nā noi.
  3. Inā ʻaʻohe āu mea kūʻai aku API, e hoʻāʻo e hoʻonohonoho lima i ka noi ma kāu polokalamu kele pūnaewele ma ka hahai ʻana i ka nā palapala.
  4. Ke kamaʻāina ʻoe i ka syntax API, e hoʻomaka e hoʻohana iā ia i kāu nā kākoʻo.
Maʻiʻo kūʻokoʻa - Kaomi maanei  Pehea e kelepona ai i ka laina ʻāina mai ke kelepona hele

E ʻike i nā API hou: nā pūnaewele kūikawā a me nā papa kuhikuhi

Nui nā kumuwaiwai pūnaewele e ʻimi ai i nā API hou:

  • API wikiwiki: ʻO ka pūnaewele API honua nui loa me ka 10,000 API ākea a me 1 miliona mau mea hoʻomohala ikaika.
  • Nā API no ka lehulehu: Hoʻopili i nā API mamao i loko o nā ʻāpana niche 40 no ka ʻimi maʻalahi.
  • APIForThat y APIList: Nā papa inoa o nā API pūnaewele ma mua o 500 me ka ʻike kikoʻī e pili ana i kā lākou hoʻohana.

Nā ʻīpuka API: Hoʻokele maikaʻi no nā mea kūʻai aku ʻoihana

ʻO nā ʻīpuka API nā mea hana hoʻokele no nā mea kūʻai aku ʻoihana e hoʻohana ana i kahi ākea o nā lawelawe backend. Na lākou ke kuleana no nā hana maʻamau e like me:

  • Hōʻoia mea hoʻohana
  • Nā hanauna o nāʻikepili
  • Hoʻoponopono uku pili i nā kelepona API

GraphQL: he ʻōlelo nīnau no nā API maʻalahi a maikaʻi

ʻO GraphQL kahi ʻōlelo nīnau i hoʻolālā ʻia no nā API. Hoʻopili ia i ka hāʻawi ʻana i nā mea kūʻai aku i ka ʻikepili a lākou e noi ai, e hana wikiwiki ana i nā API, maʻalahi a maʻalahi hoʻi e hoʻomohala. Me GraphQL, hiki i nā mea hoʻomohala mua ke nīnau i nā ʻikepili he nui, microservices, a me nā API me kahi hopena hoʻokahi.

Nā lawelawe e like AWS AppSync Hoʻomaʻamaʻa lākou i ka hoʻomohala ʻana o GraphQL API ma o ka mālama pono ʻana i ka hoʻopili paʻa ʻana i nā kumu ʻikepili a me ka hoʻouna ʻana i nā mea hou i ka manawa maoli i nā miliona o nā mea kūʻai aku.

ʻO nā API ka iwi kuamoʻo o ke kamaʻilio polokalamu i ka ʻāina ʻenehana o kēia mau lā. ʻO kona hiki ke hoʻohui i nā ʻōnaehana, hoʻoikaika i ka hana hou a hoʻoikaika i ka hoʻomohala ʻana hana ia lakou i mau mea hana pono ole. Ma ka hoʻomaopopo ʻana i kāna hana, hoʻolālā, a me nā hana maikaʻi loa, hiki i nā mea hoʻomohala ke hoʻohana i kona mana piha e hana i nā noi ʻoi aku ka ikaika, maʻalahi, a me ka pili. ʻO nā API ke kī i ka wehe ʻana i ke ao holoʻokoʻa o nā mea hiki i ka honua hoihoi o ka hoʻomohala polokalamu.