Intro
Иш тактада же түзмөктө бир нече чыкылдатуу менен каалаган убакта каалаган нерсени сатып алууга, сатууга же жарыялоого болот. Бул так кантип болот? Кантип маалымат ушул жерден тиги жерге жетеби? таанылбаган баатыр API болуп саналат.
бир API деген эмне?
API дегенди билдирет КОЛДОНУУЧУ ПРОГРАММАЛАР ИНТЕРФЕЙСИ. API программалык камсыздоонун компонентин, анын операцияларын, кириштерин, чыгыштарын жана негизги түрлөрүн билдирет. Бирок сиз APIди жөнөкөй англис тилинде кантип түшүндүрөсүз? API сиздин өтүнүчүңүздү тиркемеден өткөрүп, жоопту сизге кайра жеткирүүчү кабарчы катары иштейт.
Мисал 1: Сиз онлайн учактарды издеп жатканда. Сиз авиакомпаниянын веб-сайты менен иштешесиз. Веб-сайтта отургучтар жана рейстин баасы ошол күнү жана убактысы боюнча толук маалымат берет. Сиз тамак же отургуч, жүк же үй жаныбарлары суроо-талаптарды тандайсыз.
Бирок, эгер сиз авиакомпаниянын түз веб-сайтын колдонбосоңуз же көптөгөн авиакомпаниялардын маалыматтарын бириктирген онлайн туристтик агентти колдонуп жатсаңыз. Маалымат алуу үчүн тиркеме авиакомпаниянын API менен иштешет. API - бул туристтик агенттин веб-сайтынан авиакомпаниянын тутумуна маалыматтарды ала турган интерфейс.
Ал ошондой эле авиакомпаниянын жообун алып, дароо кайра жеткирет. Бул саякат кызматы менен авиакомпаниянын тутумдарынын ортосундагы өз ара аракеттенүүнү жеңилдетет - рейсти брондоо үчүн. API программалары, маалымат структуралары, объект класстары жана өзгөрмөлөр үчүн китепкананы камтыйт. Мисалы, SOAP жана REST кызматтары.
Мисал 2: Best Buy өзүнүн веб-сайты аркылуу өзгөчө күндүн баасын сунуш кылат. Ушул эле маалымат анын мобилдик тиркемесинде. Колдонмо ички баа системасы жөнүндө кабатырланбайт - ал Deal of Day API'ге чалып, баанын өзгөчөлүгү эмнеде? Best Buy колдонмо акыркы колдонуучуга көрсөткөн стандарттуу форматта суралган маалымат менен жооп берет.
Мисал 3: коомдук медиа үчүн API абдан маанилүү болуп саналат. Колдонуучулар мазмунга кире алышат жана эсептердин жана сырсөздөрдүн санын аз сактай алышат, ошондуктан алар жөнөкөй нерселерди сактай алышат.
- Twitter API: Көпчүлүк Twitter функциялары менен өз ара аракеттениңиз
- Facebook API: Төлөмдөр, колдонуучу маалыматтары жана кирүү үчүн
- Instagram API: Колдонуучуларды белгилеңиз, тренддеги сүрөттөрдү көрүңүз
REST & SOAP API жөнүндө эмне айтууга болот?
SOAP жана REST Web API деп аталган API керектөөчү кызматты колдонуңуз. Веб кызматы маалыматтын алдын ала билимине көз каранды эмес. SOAP жеңил платформадан көз карандысыз веб-кызмат протоколу. SOAP - бул XML негизиндеги билдирүү протоколу. SOAP желе кызматынан айырмаланып, Restful кызматы чекиттен чекитке байланыш үчүн курулган REST архитектурасын колдонот.
SOAP Web кызматы
- САМЫН Жөнөтүүчү – билдирүү түзүү жана берүү.
- САМЫН кабыл алуучу – кабарды алат жана иштетет.
- SOAP Intermediary - баш блокторду кабыл алат жана иштетет.
RESTful Веб кызматы
Өкүлчүлүк мамлекеттик өткөрүп берүү (REST) кардар менен сервердин ортосундагы мамилеге жана мамлекеттин процессине байланыштуу. Эс алуу архитектурасы, REST сервери кардарга ресурстук мүмкүнчүлүктү камсыз кылат. Эс алуу ресурстарды окуу жана өзгөртүү же жазуу менен алектенет. Uniform Identifier (URI) документти камтыган ресурстарды аныктайт. Бул ресурс абалын басып алат.
REST SOAP архитектурасына караганда жеңилирээк. Ал SOAP архитектурасы колдонгон XMLдин ордуна берилиштерди бөлүшүүгө жана берилиштерди колдонууну жеңилдеткен JSON тилин талдайт.
Restful Web Service долбоорлоонун бир нече принциптери бар, алар:
- Даректүүлүк – Ар бир ресурста жок дегенде бир URL болушу керек.
- Жарандыгы жок – бейпилдик кызматы – жарандыгы жок кызмат. Сурам кызматтын мурунку сурамдарынан көз каранды эмес. HTTP жарандыгы жок протоколдун долбоору болуп саналат.
- Кэштелет - тутумда кэштелуучу сактагыч катары белгиленген маалыматтар жана келечекте кайра колдонулат. Ошол эле натыйжаларды чыгаруунун ордуна ошол эле суроого жооп катары. Кэш чектөөлөрү жооп берилиштерин кэштелуучу же кэштелбеген деп белгилөөгө мүмкүндүк берет.
- Бирдиктүү интерфейс – Кирүү үчүн жалпы жана стандартташтырылган интерфейсти колдонууга мүмкүндүк берет. HTTP ыкмаларынын аныкталган жыйнагын колдонуу. Бул түшүнүктөрдү сактоо, REST ишке ашыруу жеңил болот.
RESTтин артыкчылыктары
- Кабарлар үчүн жөнөкөй форматты колдонот
- Күчтүү узак мөөнөттүү натыйжалуулукту сунуш кылат
- Бул жарандыгы жок байланышты колдойт
- HTTP стандарттарын жана грамматиканы колдонуңуз
- Маалымат булак катары жеткиликтүү
RESTтин кемчиликтери
- Коопсуздук транзакциялары ж.
- REST сурамдары масштабдуу эмес
REST vs САМЫН салыштыруу
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's Cocoa.
жыйынтыктоо
API'лер бардык жерде бар, мейли сиз учуу ээлеп жатасызбы же социалдык медиа тиркемелери менен алектенип жатасызбы. SOAP API XML байланыштарына негизделген, ал REST APIден өзгөчө конфигурацияны талап кылбаганы менен айырмаланат.
Rest Веб кызматтарын долбоорлоо белгилүү бир түшүнүктөрдү, анын ичинде даректүүлүк, жарансыздык, кэштештирүү жана стандарттык интерфейсти камтышы керек. API чыгаруу эрежелери үч категорияга бөлүнүшү мүмкүн: жеке API'лер, өнөктөш API'лер жана коомдук API'лер.
Бул макаланы окуп үчүн рахмат. Колдонмо боюнча биздин макаланы караңыз API коопсуздук 2022.
