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 веб қызметі
- SOAP жіберуші – хабарлама жасау және жіберу.
- SOAP Receiver – хабарламаны алады және өңдейді.
- SOAP Intermediary – тақырып блоктарын қабылдайды және өңдейді.
RESTful веб-қызметі
Өкілдік күйді тасымалдау (REST) клиент пен сервер арасындағы қатынасқа және күйдің қалай өңделетініне қатысты. Демалыс архитектурасы, REST сервері клиентке ресурс қатынасын қамтамасыз етеді. Rest ресурстарды оқуды және өзгертуді немесе жазуды басқарады. Бірыңғай идентификатор (URI) құжатты қамтитын ресурстарды анықтайды. Бұл ресурс күйін түсіреді.
REST SOAP архитектурасына қарағанда жеңілірек. Ол SOAP архитектурасы пайдаланатын XML орнына деректерді ортақ пайдалануға мүмкіндік беретін және деректерді пайдалануды жеңілдететін адам оқи алатын JSON тілін талдайды.
Restful Web Service жобалаудың бірнеше принциптері бар, олар:
- Мекенжайлық – әрбір ресурста кемінде бір 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-ден ерекше конфигурацияны қажет етпейтіндігімен ерекшеленеді.
Rest веб-қызметтерін жобалау белгілі бір ұғымдарды, соның ішінде мекенжайлық, азаматтығы жоқтық, кэштеу және стандартты интерфейсті сақтауы керек. API шығару ережелерін үш санатқа бөлуге болады: жеке API, серіктес API және жалпы API.
Осы мақаланы оқығаныңыз үшін рахмет. Нұсқаулық туралы біздің мақаланы қараңыз API қауіпсіздігі 2022.
