Танилцуулга
Ширээний компьютер эсвэл төхөөрөмж дээр хэдхэн товшилтоор хүн хүссэн үедээ юу ч худалдаж авах, зарах, нийтлэх боломжтой. Энэ нь яг яаж болдог вэ? Хэрхэн мэдээлэл эндээс тийшээ явах уу? Танигдаагүй баатар бол 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: Твиттерийн ихэнх функцтэй харилцах
- Facebook API: Төлбөр, хэрэглэгчийн өгөгдөл, нэвтрэх зориулалттай
- Instagram API: Хэрэглэгчдийг шошголох, трэнд болж буй зургуудыг үзэх
REST & SOAP API-ийн талаар юу хэлэх вэ?
SOAP болон REST Web API гэж нэрлэгддэг API ашигладаг үйлчилгээг ашиглах. Вэб үйлчилгээ нь мэдээллийн өмнөх мэдлэгээс хамаардаггүй. SOAP нь платформоос үл хамаарах вэб үйлчилгээний протокол юм. SOAP нь XML дээр суурилсан мессежийн протокол юм. SOAP вэб үйлчилгээнээс ялгаатай нь Restful үйлчилгээ нь цэгээс цэг рүү харилцах зориулалттай REST архитектурыг ашигладаг.
SOAP вэб үйлчилгээ
- САВАН илгээгч – мессеж үүсгэх, дамжуулах.
- САВАН хүлээн авагч – мессежийг хүлээн авч боловсруулдаг.
- SOAP Intermediary- толгойн блокуудыг хүлээн авч боловсруулдаг.
RESTful вэб үйлчилгээ
Төлөөлөлийн төрийн шилжүүлэг (REST) нь үйлчлүүлэгч болон серверийн хоорондын харилцаа, төлөв хэрхэн боловсруулагддагтай холбоотой. Амралтын архитектур, REST сервер нь үйлчлүүлэгчид нөөцийн хандалтыг хангадаг. Амралт нь эх сурвалжийг унших, өөрчлөх, бичих ажлыг зохицуулдаг. Uniform Identifier (URI) нь баримт бичгийг агуулсан нөөцийг тодорхойлдог. Энэ нь нөөцийн төлөвийг авах болно.
REST нь SOAP архитектураас хөнгөн. Энэ нь SOAP архитектурын ашигладаг XML-ийн оронд өгөгдөл хуваалцах, ашиглахад хялбар JSON хэлийг задлан шинжилдэг.
Амралттай вэб үйлчилгээг зохион бүтээх хэд хэдэн зарчим байдаг бөгөөд эдгээр нь:
- Хаягийн боломж - Нөөц бүр дор хаяж нэг URL-тай байх ёстой.
- Харьяалалгүй байдал – Амрах үйлчилгээ нь харьяалалгүй үйлчилгээ юм. Хүсэлт нь үйлчилгээний өмнөх хүсэлтээс үл хамаарна. HTTP нь загвараар харьяалалгүй протокол юм.
- Cacheable – Кэш хийх боломжтой гэж тэмдэглэгдсэн өгөгдөл нь системд хадгалагдаж, ирээдүйд дахин ашиглагдана. Ижил үр дүнг гаргахын оронд ижил хүсэлтийн хариу. Кэшийн хязгаарлалт нь хариултын өгөгдлийг кэш хийх боломжтой эсвэл кэш хийх боломжгүй гэж тэмдэглэх боломжийг олгодог.
- Нэг төрлийн интерфэйс – Нийтлэг бөгөөд стандартчилагдсан интерфэйсийг хандалтад ашиглахыг зөвшөөрдөг. HTTP аргуудын тодорхой цуглуулгыг ашиглах. Эдгээр үзэл баримтлалыг дагаж мөрдөх нь REST-ийн хэрэгжилт нь хөнгөн гэдгийг баталгаажуулдаг.
REST-ийн давуу тал
- Мессежийн хувьд илүү энгийн форматыг ашигладаг
- Илүү урт хугацааны үр ашгийг санал болгодог
- Энэ нь харьяалалгүй харилцаа холбоог дэмждэг
- HTTP стандартууд болон дүрмийг ашигла
- Өгөгдлийг нөөц болгон авах боломжтой
REST-ийн сул тал
- Аюулгүй байдлын гүйлгээ гэх мэт вэб үйлчилгээний стандартад алдаа гарсан.
- REST хүсэлтийг өргөтгөх боломжгүй
REST ба савангийн харьцуулалт
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-аас ялгаатай.
Амралтын вэб үйлчилгээг зохион бүтээхдээ хаягжилт, харьяалалгүй байх, кэш хийх чадвар, стандарт интерфэйс зэрэг тодорхой ойлголтуудыг баримтлах ёстой. API хувилбарын дүрмийг хувийн API, түнш API, нийтийн API гэсэн гурван ангилалд хувааж болно.
Энэ нийтлэлийг уншсан танд баярлалаа. Гарын авлагын талаархи манай нийтлэлийг уншина уу API аюулгүй байдал 2022.
