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.
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:
- 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.
- '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.
- 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.
- 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:
- Ka malu: Hiki ke pilikia nā wahi hopena i ka hoʻouka ʻana, no laila pono ka nānā ʻana iā lākou.
- Wahi: Hiki i nā wahi hopena kiʻekiʻe ke hana i nā bottlenecks a pili i ka hana ʻōnaehana.
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:
- 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.
- 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.
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:
- 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.
- 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.
- Ho'āʻo API: Hana i ka hoʻāʻo nui e pale aku i nā hewa a hōʻoia i ka palekana.
- 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.
- 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:
- 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.
- Hoʻonohonoho a Mea kūʻai aku HTTP API e hana maʻalahi i nā noi.
- 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.
- Ke kamaʻāina ʻoe i ka syntax API, e hoʻomaka e hoʻohana iā ia i kāu nā kākoʻo.
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.
ʻO wau ʻo Sebastián Vidal, he ʻenekinia kamepiula makemake nui i ka ʻenehana a me DIY. Eia kekahi, ʻo wau ka mea nāna i hana tecnobits.com, kahi aʻu e kaʻana like ai i nā kumu aʻo e hoʻomaʻamaʻa a hoʻomaopopo ʻia ka ʻenehana i nā mea a pau.
