Увядзенне
З дапамогай некалькіх пстрычак на працоўным стале або прыладзе можна купіць, прадаць або апублікаваць што заўгодна ў любы час. Як менавіта гэта адбываецца? Як інфармацыя дабрацца адсюль туды? Неапазнаны герой - API.
Што такое API?
API расшыфроўваецца як an ІНТЕРФЭЙС ПРЫКЛАДНАГА ПРАГРАМАВАННЯ. API выражае кампанент праграмнага забеспячэння, яго аперацыі, уводы, вывады і асноўныя тыпы. Але як вы растлумачыце API на простай англійскай мове? API функцыянуе як мессенджер, які перадае ваш запыт з прыкладання і дастаўляе вам адказ.
Прыклад 1: Калі вы шукаеце рэйсы ў Інтэрнэце. Вы ўзаемадзейнічаеце з вэб-сайтам авіякампаніі. На вэб-сайце падрабязна апісваюцца месцы і кошт рэйса на дадзены дзень і час. Вы самі выбіраеце ежу або месцы, багаж або запыты хатніх жывёл.
Але калі вы не карыстаецеся прамым вэб-сайтам авіякампаніі або выкарыстоўваеце інтэрнэт-турагент, які аб'ядноўвае даныя многіх авіякампаній. Для атрымання інфармацыі праграма ўзаемадзейнічае з API авіякампаніі. API - гэта інтэрфейс, які прымае даныя з вэб-сайта турагента ў сістэму авіякампаніі.
Ён таксама прымае адказ авіякампаніі і неадкладна дастаўляе. Гэта палягчае ўзаемадзеянне паміж турыстычнай службай і сістэмамі авіякампаніі для браніравання рэйса. API ўключае ў сябе бібліятэку для працэдур, структур дадзеных, класаў аб'ектаў і зменных. Напрыклад, сэрвісы SOAP і REST.
Прыклад 2: На сваім вэб-сайце Best Buy робіць спецыяльныя цэны на "Здзелку дня". Гэтыя ж дадзеныя знаходзяцца ў яго мабільным дадатку. Прыкладанне не клапоціцца аб унутранай сістэме цэнаўтварэння - яно можа выклікаць Deal of the Day API і спытаць, што такое асаблівае цэнаўтварэнне? Best Buy адказвае запытанай інфармацыяй у стандартным фармаце, які праграма паказвае канчатковаму карыстальніку.
Прыклад 3: API для сацыяльных сетак маюць вырашальнае значэнне. Карыстальнікі могуць атрымліваць доступ да змесціва і падтрымліваць колькасць уліковых запісаў і пароляў, якія яны адсочваюць, на нізкім узроўні, каб яны маглі зрабіць усё проста.
- Twitter API: узаемадзеянне з большасцю функцый Twitter
- Facebook API: для плацяжоў, карыстальніцкіх даных і ўваходу
- API Instagram: пазначайце карыстальнікаў, праглядайце папулярныя фатаграфіі
Што наконт REST & SOAP API?
SOAP і REST выкарыстоўваць службу, якая выкарыстоўвае API, вядомую як Web API. Вэб-сэрвіс не залежыць ад папярэдняга веды інфармацыі. SOAP - гэта пратакол вэб-сэрвісу, які не залежыць ад платформы. SOAP - гэта пратакол абмену паведамленнямі на аснове XML. У адрозненне ад вэб-сэрвісу SOAP, сэрвіс Restful выкарыстоўвае архітэктуру REST, створаную для сувязі кропка-кропка.
Вэб-сэрвіс SOAP
- SOAP Sender – стварэнне і перадача паведамлення.
- SOAP Receiver - атрымлівае і апрацоўвае паведамленне.
- Пасярэднік SOAP - атрымлівае і апрацоўвае блокі загалоўкаў.
Вэб-сэрвіс RESTful
Representational State Transfer (REST) ставіцца да адносін паміж кліентам і серверам і да таго, як апрацоўваецца стан. Архітэктура Rest, сервер REST забяспечвае кліенту доступ да рэсурсаў. Rest апрацоўвае чытанне і змяненне або запіс рэсурсаў. Універсальны ідэнтыфікатар (URI) вызначае рэсурсы, якія змяшчаюць дакумент. Гэта зафіксуе стан рэсурсу.
REST лягчэйшы за архітэктуру SOAP. Ён аналізуе JSON, зразумелую для чалавека мову, якая дазваляе абменьвацца данымі і лягчэй выкарыстоўваць даныя, замест XML, які выкарыстоўваецца ў архітэктуры SOAP.
Ёсць некалькі прынцыпаў распрацоўкі вэб-службы Restful:
- Адраснасць - кожны рэсурс павінен мець хаця б адзін URL.
- Без грамадзянства – паслуга Restful з'яўляецца паслугай без грамадзянства. Запыт не залежыць ад мінулых запытаў службы. HTTP па задуме з'яўляецца пратаколам без стану.
- Кэшуемыя – даныя, пазначаныя як кэшуемыя, захоўваюцца ў сістэме і выкарыстоўваюцца паўторна ў будучыні. У якасці адказу на той жа запыт замест атрымання тых жа вынікаў. Абмежаванні кэша дазваляюць пазначаць дадзеныя адказу як кэшуемыя або некэшуемыя.
- Адзіны інтэрфейс – Дазваляе выкарыстоўваць агульны і стандартызаваны інтэрфейс для доступу. Выкарыстанне вызначанай калекцыі метадаў HTTP. Захаванне гэтых канцэпцый гарантуе, што рэалізацыя REST лёгкая.
Перавагі REST
- Выкарыстоўвае больш просты фармат для паведамленняў
- Прапануе больш моцную доўгатэрміновую эфектыўнасць
- Ён падтрымлівае сувязь без стану
- Выкарыстоўвайце стандарты HTTP і граматыку
- Дадзеныя даступныя як рэсурс
Недахопы REST
- Не адпавядае стандартам вэб-сэрвісаў, такім як ахоўныя транзакцыі і г.д.
- Запыты REST не маштабуюцца
Параўнанне REST і SOAP
Адрозненні паміж вэб-сэрвісамі SOAP і REST.
Вэб-сэрвіс SOAP | Вэб-сэрвіс Rest |
Патрабуецца значная карысная нагрузка ўводу ў параўнанні з 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.
