Intro
Бо чанд клик дар мизи корӣ ё дастгоҳ, кас метавонад дар вақти дилхоҳ чизе бихарад, фурӯшад ё нашр кунад. Аниқтараш ин чӣ гуна мешавад? Чӣ тавр маълумот аз ин ҷо ба он ҷо меравед? Қаҳрамони эътирофнашуда API аст.
API чист?
API маънои як ИНТЕРФЕЙСИ ПРОГРАММАСОЗИИ ПРОГРАММАХО. API ҷузъи нармафзор, амалиётҳо, вурудҳо, натиҷаҳо ва намудҳои асосиро ифода мекунад. Аммо шумо чӣ гуна API-ро бо забони оддии англисӣ шарҳ медиҳед? API ҳамчун паёмнависе амал мекунад, ки дархости шуморо аз барнома интиқол медиҳад ва посухро ба шумо бармегардонад.
Мисоли 1: Вақте ки шумо дар ҷустуҷӯи парвозҳо онлайн ҳастед. Шумо бо вебсайти ширкати ҳавопаймоӣ ҳамкорӣ мекунед. Вебсайт ҷои нишаст ва арзиши парвозро дар ин сана ва вақти мушаххас тафсилот медиҳад. Шумо хӯрок ё ҷои нишаст, бағоҷ ё дархости ҳайвоноти худро интихоб мекунед.
Аммо, агар шумо вебсайти мустақими ширкати ҳавопаймоиро истифода набаред ё агенти сайёҳии онлайнро истифода баред, ки маълумотро аз бисёр ширкатҳои ҳавопаймоӣ муттаҳид мекунад. Барои гирифтани маълумот, барнома бо API-и ширкати ҳавопаймоӣ ҳамкорӣ мекунад. API интерфейсест, ки маълумотро аз вебсайти агенти сайёҳӣ ба системаи ширкати ҳавопаймоӣ мегирад.
Он инчунин посухи ширкати ҳавопаймоиро мегирад ва рост баргардонад. Ин ҳамкории байни хадамоти сайёҳӣ ва системаҳои ширкати ҳавопаймоиро осон мекунад - барои фармоиш додани парвоз. API дорои китобхона барои реҷаҳо, сохторҳои додаҳо, синфҳои объектҳо ва тағирёбандаҳо мебошад. Масалан, хидматҳои SOAP ва REST.
Мисоли 2: Best Buy тавассути вебсайти худ нархгузории махсуси рӯзро фароҳам меорад. Ин маълумот дар замимаи мобилии он мавҷуд аст. Барнома дар бораи системаи дохилии нархгузорӣ нигарон нест - он метавонад ба API Deal of Day занг занад ва пурсад, ки нархгузорӣ чист? Best Buy бо маълумоти дархостшуда дар формати стандартие, ки барнома ба корбари ниҳоӣ нишон медиҳад, ҷавоб медиҳад.
Мисол 3: API-ҳо барои васоити ахбори иҷтимоӣ муҳиманд. Истифодабарандагон метавонанд ба мундариҷа дастрасӣ пайдо кунанд ва шумораи ҳисобҳо ва паролҳоеро, ки онҳо пайгирӣ мекунанд, кам нигоҳ доранд, то онҳо корҳоро содда нигоҳ доранд.
- API Twitter: Бо аксари функсияҳои Twitter ҳамкорӣ кунед
- API Facebook: Барои пардохтҳо, маълумоти корбар ва воридшавӣ
- Instagram API: Корбаронро барчасп кунед, аксҳои тамоюлиро бубинед
Дар бораи REST & SOAP API чӣ гуфтан мумкин аст?
собун ва РЕТ хидмати API-ро истифода баред, ки бо номи Web API маълум аст. Хидмати веб аз ягон дониши қаблии иттилоот вобаста нест. SOAP як протоколи хидматрасонии веб аст, ки аз платформаи сабукрав мустақил аст. SOAP як протоколи паёмнависии ба XML асосёфта мебошад. Баръакси хидмати веби SOAP, хидмати Restful меъмории REST-ро истифода мебарад, ки барои муоширати нуқта ба нуқта сохта шудааст.
Хидмати веби SOAP
- Ирсолкунандаи SOAP - эҷод ва интиқоли паём.
- Қабулкунандаи SOAP - паёмро қабул ва коркард мекунад.
- SOAP Intermediary - блокҳои сарлавҳаро қабул ва коркард мекунад.
Хидмати веби RESTful
Интиқоли намояндагии давлатӣ (REST) ба муносибати байни муштарӣ ва сервер ва чӣ гуна равандҳои давлат алоқаманд аст. Архитектураи истироҳат, сервери REST дастрасии захираҳоро ба муштарӣ таъмин мекунад. Истироҳат хондан, тағир додан ё навиштани захираҳоро идора мекунад. Муайянкунандаи ягона (URI) захираҳоро барои дорои ҳуҷҷат муайян мекунад. Ин ҳолати захираҳоро ба даст меорад.
REST назар ба меъмории SOAP сабуктар аст. Он ба ҷои XML, ки меъмории SOAP истифода мебарад, JSON, забони барои инсон хондашаванда, ки ба мубодилаи додаҳо имкон медиҳад ва истифодаи онро осонтар мекунад.
Якчанд принсипҳои тарҳрезии Web Service Restful мавҷуданд, ки инҳоянд:
- Нишонӣ - Ҳар як манбаъ бояд ҳадди аққал як URL дошта бошад.
- Бешаҳрвандӣ - Хизматрасонии фароғатӣ хидмати бидуни шаҳрвандӣ мебошад. Дархост аз ҳама гуна дархостҳои гузаштаи хадамот новобаста аст. HTTP аз рӯи тарҳрезӣ як протоколи бидуни шаҳрвандӣ мебошад.
- Кэшшаванда - Маълумоте, ки ҳамчун захираи кэшшаванда дар система қайд карда шудааст ва дар оянда дубора истифода мешавад. Ҳамчун посух ба ҳамон дархост ба ҷои тавлиди ҳамон натиҷаҳо. Маҳдудиятҳои кэш имкон медиҳанд, ки маълумотҳои ҷавобӣ ҳамчун кэшшаванда ё ғайриимкон қайд карда шаванд.
- Интерфейси ягона - Имкон медиҳад интерфейси умумӣ ва стандартишуда барои дастрасӣ. Истифодаи маҷмӯи муайяни усулҳои HTTP. Риоя кардани ин консепсияҳо кафолат медиҳад, ки татбиқи REST сабук аст.
Афзалиятҳои REST
- Барои паёмҳо формати соддатарро истифода мебарад
- Самаранокии қавитари дарозмуддатро пешниҳод мекунад
- Он муоширати бешаҳрвандиро дастгирӣ мекунад
- Стандартҳои HTTP ва грамматикаро истифода баред
- Маълумот ҳамчун манбаъ дастрас аст
Камбудиҳои REST
- Дар стандартҳои хидматрасонии веб, ба монанди Амниятҳои Амният ва ғ.
- Дархостҳои REST миқёспазир нестанд
Муқоисаи REST ва SOAP
Тафовут байни хидматҳои веби SOAP ва REST.
Хидмати веби SOAP | Хидмати веби истироҳат |
Дар муқоиса бо REST бори вазнини вурудро талаб мекунад. | REST сабук аст, зеро он URI-ро барои шаклҳои додаҳо истифода мебарад. |
Тағйирот дар хидматҳои SOAP аксар вақт ба тағирёбии назарраси код дар тарафи муштарӣ оварда мерасонад. | Тағйироти хидматҳо дар таъминоти веби REST ба коди муштарӣ таъсир намерасонад. |
Навъи бозгашт ҳамеша навъи XML аст. | Вобаста ба шакли маълумоти баргардонидашуда гуногунҷабҳаро таъмин мекунад. |
Протоколи паём дар асоси XML | Протоколи меъморӣ |
Дар охири муштарӣ китобхонаи SOAP-ро талаб мекунад. | Ҳеҷ гуна дастгирии китобхона лозим нест, ки одатан тавассути HTTP истифода мешавад. |
WS-Security ва SSL -ро дастгирӣ мекунад. | SSL ва HTTPS -ро дастгирӣ мекунад. |
SOAP амнияти худро муайян мекунад. | Хидматҳои веби RESTful чораҳои бехатариро аз нақлиёти асосӣ мерос мегиранд. |
Намудҳои сиёсати релизҳои API
Сиёсати барориши API инҳоянд:
Сиёсати нашри хусусӣ:
API танҳо барои истифодаи дохилии ширкат дастрас аст.
Сиёсати озод кардани шарикон:
API танҳо барои шарикони тиҷории мушаххас дастрас аст. Ширкатҳо метавонанд сифати API-ро назорат кунанд, зеро назорат аз болои кӣ ба он дастрасӣ дорад.
Сиёсати нашри оммавӣ:
API барои истифодаи ҷамъиятӣ аст. Дастрасии сиёсати озодкунӣ барои омма дастрас аст. Мисол: Microsoft Windows API ва Какаои Apple.
хулоса
API-ҳо дар ҳама ҷо мавҷуданд, новобаста аз он ки шумо парвоз фармоиш медиҳед ё бо барномаҳои ВАО иҷтимоӣ машғул мешавед. SOAP API ба коммуникатсияҳои XML асос ёфтааст, он аз REST API бо он фарқ мекунад, ки ягон конфигуратсияи махсусро талаб намекунад.
Тарҳрезии хидматҳои Web Rest бояд ба мафҳумҳои муайян, аз ҷумла суроғавӣ, бидуни шаҳрвандӣ, кэшпазирӣ ва интерфейси стандартӣ мувофиқат кунад. Қоидаҳои барориши API-ро метавон ба се категория тақсим кард: API-ҳои хусусӣ, API-ҳои шарик ва API-ҳои ҷамъиятӣ.
Ташаккур ба шумо барои хондани ин мақола. Мақолаи моро дар бораи роҳнамо санҷед API Амният 2022.
