API гэж юу вэ, API хөгжүүлэхэд анхаарах зүйлс?

API (Application Programming Interface) нь илүү сайн үйлчилгээ үзүүлэхийн тулд өөр программ хангамж, платформ эсвэл төхөөрөмжийн онцлог, үйлчилгээг ашиглах боломжийг програм хангамж эсвэл апп-д олгодог заавар, стандарт эсвэл шаардлагын багц юм. Товчхондоо, энэ нь програмууд хоорондоо харилцах боломжийг олгодог зүйл юм.

 

API нь өгөгдөлтэй харьцах эсвэл хоёр бүтээгдэхүүн, үйлчилгээний хоорондын харилцаа холбоог идэвхжүүлдэг бүх програмын суурь юм. Энэ нь гар утасны програм эсвэл платформыг бусад програмууд/платформуудтай мэдээллээ хуваалцах боломжийг олгож, хөгжүүлэгчдийг оролцуулалгүйгээр хэрэглэгчийн туршлагыг хөнгөвчлөх боломжийг олгодог. 

Нэмж дурдахад API нь эхнээс нь харьцуулах боломжтой платформ эсвэл програм хангамжийг бий болгох хэрэгцээг арилгадаг. Та одоогийн нэг эсвэл өөр платформ эсвэл програмыг ашиглаж болно. Эдгээр шалтгааны улмаас API боловсруулах үйл явц нь програм хөгжүүлэгчид болон компанийн удирдлагуудын анхаарлын төвд байдаг.

 

API ажиллаж байна

Та нислэг захиалахын тулд XYZ програм эсвэл вэбсайт нээсэн гэж бодъё. Та маягтыг бөглөж, явах, ирэх цаг, хот, нислэгийн мэдээлэл болон бусад шаардлагатай мэдээллийг оруулаад, дараа нь илгээсэн. Хэдхэн секундын дотор нислэгийн жагсаалт үнэ, цаг, суудал болон бусад дэлгэрэнгүй мэдээлэлтэй хамт дэлгэцэн дээр гарч ирнэ. Энэ нь үнэндээ яаж болдог вэ?

 

Ийм хатуу мэдээллийг өгөхийн тулд платформ нь агаарын тээврийн компанийн вэбсайт руу өөрсдийн мэдээллийн санд хандаж, хэрэглээний програмын интерфейсээр дамжуулан холбогдох мэдээллийг авах хүсэлтийг илгээсэн. Вэбсайт нь API интеграци нь платформд хүргэсэн өгөгдлийн дагуу хариу өгсөн бөгөөд платформ үүнийг дэлгэц дээр харуулсан.

 

Энд нислэгийн захиалгын програм/платформ болон агаарын тээврийн компанийн вэб сайт нь эцсийн цэгийн үүрэг гүйцэтгэдэг бол API нь өгөгдөл хуваалцах үйл явцыг оновчтой болгох завсрын хэрэгсэл юм. Төгсгөлийн цэгүүдтэй харилцах тухай ярихдаа API нь REST (Төлөөлөгчийн төлөв дамжуулах) ба SOAP (Энгийн объектын хандалтын протокол) гэсэн хоёр аргаар ажилладаг.

 

Хэдийгээр хоёр арга хоёулаа үр дүнтэй үр дүнг авчирдаг боловч a гар утасны програм хөгжүүлэх компани SOAP API нь хүнд бөгөөд платформоос хамааралтай байдаг тул SAP-аас REST-ийг илүүд үздэг.

 

API-ийн амьдралын мөчлөг, ноу-хау API хэрхэн ажилладагийг нарийвчлан ойлгохын тулд, өнөөдөр манай мэргэжилтнүүдтэй холбоо барина уу!

 

API хөгжүүлэх хэрэгслүүд

API-г бий болгох үйл явцад тоноглогдсон API дизайны олон хэрэгсэл, технологи байдаг ч хөгжүүлэгчдэд зориулсан API-г хөгжүүлэх алдартай API хөгжүүлэлтийн технологи, хэрэгслүүд нь:

 

• Апиги

Энэ нь Google-ийн API менежментийн үйлчилгээ үзүүлэгч бөгөөд хөгжүүлэгчид болон бизнес эрхлэгчдэд API интеграцийн хандлагыг дахин бий болгосноор дижитал өөрчлөлтийг ялахад тусалдаг.

 

• APIMatic болон API Transformer

Эдгээр нь API хөгжүүлэх бусад алдартай хэрэгслүүд юм. Тэд API-д зориулсан форматаас дээд зэргийн чанартай SDK болон кодын хэсгүүдийг бүтээж, тэдгээрийг RAML, API Blueprint гэх мэт бусад үзүүлэлт болгон хувиргах нарийн төвөгтэй автомат үүсгэх хэрэгслийг санал болгодог.

 

• API шинжлэх ухаан 

Энэ хэрэгслийг үндсэндээ дотоод API болон гадаад API-ийн гүйцэтгэлийг үнэлэхэд ашигладаг.

 

• API сервергүй архитектур 

Эдгээр бүтээгдэхүүнүүд нь мобайл програм хөгжүүлэгчдэд үүлэнд суурилсан серверийн дэд бүтцийн тусламжтайгаар API-г зохион бүтээх, бүтээх, хэвлэх, байршуулахад тусалдаг.

 

• API-платформ

Энэ нь вэб API боловсруулахад тохиромжтой, нээлттэй эхийн PHP хүрээнүүдийн нэг юм.

 

• Үнэн0

Энэ нь API-г баталгаажуулах, зөвшөөрөхөд ашигладаг таних удирдлагын шийдэл юм.

 

• ClearBlade

Энэ бол IoT технологийг өөрийн үйл ажиллагаанд нэвтрүүлэхэд зориулагдсан API менежментийн үйлчилгээ үзүүлэгч юм.

 

• GitHub

Энэхүү нээлттэй эхийн git репозиторын байршуулах үйлчилгээ нь хөгжүүлэгчдэд кодын файлуудыг удирдах, татах хүсэлт, хувилбарын хяналт, бүлэгт тараагдсан сэтгэгдлүүдийг удирдах боломжийг олгодог. Энэ нь тэдэнд кодоо хувийн хадгалах газарт хадгалах боломжийг олгодог.

 

• Шуудан зөөгч

Энэ нь үндсэндээ хөгжүүлэгчдэд API-аа ажиллуулах, турших, баримтжуулах, гүйцэтгэлийг үнэлэх боломжийг олгодог API хэрэгслийн сүлжээ юм.

 

• Сваггер

Энэ нь API хөгжүүлэлтийн програм хангамжид ашиглагддаг нээлттэй эхийн хүрээ юм. GettyImages, Microsoft зэрэг томоохон технологийн аварга компаниуд Swagger ашигладаг. Дэлхий ертөнц API-уудаар дүүрэн ч API технологийн давуу талыг ашиглахад томоохон цоорхой байсаар байна. Зарим API нь уг програмыг нэгтгэх ажлыг маш хялбар болгодог бол зарим нь үүнийг хар дарсан зүүд болгон хувиргадаг.

 

Үр ашигтай API-ийн заавал байх ёстой шинж чанарууд

• Хугацаа өөрчлөх эсвэл шалгуураар хайх

Аппликейшнд байх ёстой хамгийн чухал API функц бол өөрчлөлтийн цагийн тэмдэг/шалгуураар хайх явдал юм. API нь хэрэглэгчдэд огноо гэх мэт өөр өөр шалгуурт тулгуурлан өгөгдлийг хайх боломжийг олгоно. Учир нь энэ нь анхны өгөгдөл синхрончлолын дараа л авч үзэх өөрчлөлтүүд (шинэчлэх, засах, устгах) юм.

 

• пейжерийн 

Олон удаа, бид бүрэн өгөгдлийг өөрчлөхийг хүсэхгүй байгаа, гэхдээ зүгээр л зэрвэсхэн харахыг хүсдэг. Ийм нөхцөлд API нь нэг удаад хэр их өгөгдөл, ямар давтамжтайгаар харуулахыг тодорхойлох чадвартай байх ёстой. Энэ нь мөн эцсийн хэрэглэгчдэд дугаарын талаар мэдэгдэх ёстой. өгөгдлийн хуудасны үлдэгдэл.

 

• Ангилах

Эцсийн хэрэглэгч бүх өгөгдлийн хуудсыг нэг нэгээр нь хүлээн авахын тулд API нь хэрэглэгчдэд өгөгдлийг өөрчлөх хугацаа эсвэл бусад нөхцөл байдлын дагуу эрэмбэлэх боломжийг олгох ёстой.

 

• JSON дэмжлэг эсвэл REST

Заавал биш ч API-г үр дүнтэй хөгжүүлэхийн тулд RESTful (эсвэл JSON дэмжлэгийг (REST) ​​өгдөг) гэж үзэх нь зүйтэй. REST API-ууд нь харьяалалгүй, жин багатай бөгөөд хэрэв амжилтгүй болвол гар утасны програм байршуулах процессыг дахин оролдох боломжийг танд олгоно. САВАН-ийн хувьд энэ нь нэлээд хэцүү юм. Нэмж дурдахад JSON-ийн синтакс нь ихэнх програмчлалын хэлтэй төстэй байдаг тул гар утасны програм хөгжүүлэгч үүнийг бусад хэл дээр задлан шинжлэхэд хялбар болгодог.

 

• OAuth-ээр дамжуулан зөвшөөрөл авах

Таны хэрэглээний программын интерфейс бусад аргуудаас илүү хурдан тул OAuth-ээр дамжуулан зөвшөөрөл өгөх шаардлагатай байна, та товчлуур дээр дарахад л хангалттай.

 

Товчоор хэлбэл, боловсруулах хугацаа хамгийн бага, хариу өгөх хугацаа сайн, аюулгүй байдлын түвшин өндөр байх ёстой. Аппликешнийнхээ аюулгүй байдлыг хангахын тулд API хөгжүүлэлтийн шилдэг туршлагуудад хүчин чармайлт гаргах нь нэн чухал бөгөөд энэ нь олон тооны өгөгдөлтэй холбоотой байдаг.

 

API-ийн нэр томъёо

 

1. API түлхүүр – API нь параметрээр дамжуулан хүсэлтийг шалгаж, хүсэлт гаргагчийг ойлгох үед. Зөвшөөрөгдсөн код нь хүсэлтийн түлхүүрт шилжсэн бөгөөд API KEY гэж хэлэгддэг.
2. Төгсгөлийн цэг – Нэг системийн API өөр системтэй харилцан үйлчлэх үед холбооны сувгийн нэг төгсгөлийг төгсгөлийн цэг гэж нэрлэдэг.
3. JSON - JSON эсвэл Javascript объектууд нь API хүсэлтийн параметрүүд болон хариултын хэсэгт ашиглагддаг өгөгдлийн формат болгон ашигладаг. 
4. GET - Нөөц авахын тулд API-ийн HTTP аргыг ашиглах
5. POST – Энэ нь нөөц бүрдүүлэхэд зориулсан RESTful API-ийн HTTP арга юм. 
6. OAuth – Энэ нь ямар нэгэн итгэмжлэл хуваалцахгүйгээр хэрэглэгчийн талаас хандах боломжийг олгодог стандарт зөвшөөрлийн хүрээ юм. 
7. REST - Хоёр төхөөрөмж/систем хоорондын харилцааны үр ашгийг дээшлүүлэх програмчлал. REST нь бүрэн бус зөвхөн шаардлагатай өгөгдлийг хуваалцдаг. Энэхүү архитектурт хэрэгжсэн системүүдийг "RESTful" систем гэж нэрлэдэг бөгөөд RESTful системүүдийн хамгийн гайхалтай жишээ бол World Wide Web юм.
8. SOAP – SOAP буюу Simple Object Access Protocol нь компьютерийн сүлжээн дэх вэб үйлчилгээг гүйцэтгэхэд бүтэцлэгдсэн мэдээллийг хуваалцах мессежийн протокол юм.
9. Хоцролт - Энэ нь хүсэлтээс хариу хүртэл API боловсруулах процесст зарцуулсан нийт хугацаа гэж тодорхойлогддог.
10. Rate Limiting - энэ нь хэрэглэгчийн нэг удаад API руу цохих хүсэлтийн тоог хязгаарлах гэсэн үг юм.

 

Зөв API бий болгох шилдэг туршлагууд

• Throttling ашиглах

App Throttling нь хэт их урсгалыг дахин чиглүүлэх, API-уудыг нөөцлөх, DoS (Үйлчилгээнээс татгалзах) халдлагаас хамгаалахад анхаарах маш сайн туршлага юм.

 

• Өөрийн API гарцыг Enforcer гэж үзнэ үү

Тохируулах дүрмийг тохируулах, API түлхүүрүүдийг ашиглах эсвэл OAuth-г тохируулахдаа API гарцыг хэрэгжүүлэх цэг гэж үзэх ёстой. Үүнийг зөвхөн зөв хэрэглэгчдэд өгөгдөлд хандах боломжийг олгодог цагдаа гэж үзэх хэрэгтэй. Энэ нь танд мессежийг шифрлэх эсвэл нууц мэдээллийг засах боломжийг олгох бөгөөд ингэснээр таны API-г хэрхэн ашиглаж байгааг шинжлэх, удирдах боломжтой болно.

 

• HTTP аргыг хүчингүй болгохыг зөвшөөрөх

Зарим прокси нь зөвхөн GET болон POST аргуудыг дэмждэг тул та өөрийн RESTful API-д HTTP аргыг хүчингүй болгохыг зөвшөөрөх хэрэгтэй. Үүнийг хийхийн тулд тусгай HTTP Header X-HTTP-Method-Override ашиглана уу.

 

• API болон дэд бүтцийг үнэлэх

Одоогийн байдлаар бодит цагийн дүн шинжилгээ хийх боломжтой, гэхдээ API сервер санах ой алдагдсан, CPU-ийг шавхсан эсвэл бусад асуудалтай гэж сэжиглэж байвал яах вэ? Ийм нөхцөл байдлыг харгалзан үзэхийн тулд та хөгжүүлэгчийг үүрэг хариуцлагатай байлгах боломжгүй юм. Гэсэн хэдий ч та үүнийг AWS үүл цаг гэх мэт зах зээлд байгаа олон хэрэгслийг ашиглан хялбархан хийж чадна.

 

• Аюулгүй байдлыг хангах

Та өөрийн API технологи аюулгүй байх ёстой, гэхдээ хэрэглэгчдэд ээлтэй байх зардлаар биш. Хэрэв ямар нэгэн хэрэглэгч баталгаажуулалтад 5 минутаас илүү хугацаа зарцуулдаг бол энэ нь таны API хэрэглэгчдэд ээлтэй байх боломжгүй гэсэн үг юм. Та API-ээ аюулгүй болгохын тулд токен дээр суурилсан баталгаажуулалтыг ашиглаж болно.

 

• Баримт бичиг

Эцэст нь хэлэхэд, гар утасны програмуудад зориулсан API-д зориулсан өргөн хүрээний баримт бичгийг бий болгох нь ашигтай бөгөөд энэ нь бусад гар утасны програм хөгжүүлэгчдэд бүх үйл явцыг хялбархан ойлгож, мэдээллийг илүү сайн хэрэглэгчийн туршлагыг санал болгоход ашиглах боломжийг олгодог. Өөрөөр хэлбэл, API үр дүнтэй боловсруулах явцад сайн API баримтжуулалт нь төслийг хэрэгжүүлэх хугацаа, төслийн өртөгийг бууруулж, API технологийн үр ашгийг нэмэгдүүлэх болно.