Boshqa xizmatlar bilan integratsiya (API + token)

Tarkib:

• API nima
• API token nima va nima uchun kerak
• Medfleks klinikasi tomonidan chiqarilgan ochiq API token nima (ochiq token, klinikaning tokenlari)
• Medfleksdagi klinikaning ochiq tokeni qanday muammolarni hal qiladi
• Ochiq token sherigi uchun qanday API usullari guruhlari mavjud
• Ochiq tokendan foydalanish qancha turadi
• Tokenni qanday yaratish kerak

Medflex integratsiya do'konida mavjud bo'lmagan xizmatlar bilan integratsiya qilish uchun shaxsiy hisobingizda kirish kalitini (token) yaratishingiz mumkin. Kalit siz integratsiyalashmoqchi bo'lgan xizmatning texnik xodimlariga topshirilishi kerak.

API nima

API (Application Programming Interface) - bu turli xil dasturlar va xizmatlarning bir-biri bilan o'zaro aloqada bo'lishiga imkon beradigan qoidalar, protokollar va vositalar to'plami.

Oddiy so'zlar bilan aytganda, API «язык общения»turli xil axborot tizimlari o'rtasida izchil bo'lib, turli xil xizmatlar bir-birini tushunishi va samarali ma'lumot almashishi uchun zarurdir.

API token nima va nima uchun kerak

API token-bu so'rov tashabbuskorini tasdiqlash va avtorizatsiya qilish uchun API so'rovlarini almashishda ishlatiladigan noyob kalit.

Standart API token quyidagicha: cdda9acf1bc5fdd8b148539a5f7a752fabeeecebdd121fe1a946c1e065af04be

Nima uchun ishlatiladi:

• Foydalanuvchi yoki dasturni aniqlash – API-token so'rov tizimga tanish, ruxsat etilgan, ishonchli manbadan kelganligini tasdiqlaydi
• Kirishni boshqarish-belgilangan token bilan foydalanuvchi uchun qanday API ma'lumotlari yoki funktsiyalari mavjudligini aniqlaydi
• Xavfsizlik - Login va parolni almashtiradi, bu esa ma'lumotlarning buzilishi xavfini kamaytiradi
• So'rovlarni kuzatish va cheklash-server token faoliyatini kuzatishi va so'rovlar sonini cheklashi mumkin

Medfleks klinikasi tomonidan chiqarilgan ochiq API token nima (ochiq token, klinika token)

Medfleks klinikaga turli xil xizmatlar bilan xavfsiz integratsiya qilish imkoniyatini beradi, garchi ular Medfleksning shaxsiy kabinetidagi integratsiya do'konida bo'lmasa ham. Shuningdek, integratsiya uchun mavjud bo'lgan bir qator sheriklar sukut bo'yicha ochiq token funksiyasidan foydalanadilar.

Muhim! Ochiq token orqali ma'lumotlar bir vaqtning o'zida klinikaning barcha filiallari orqali uzatiladi, ulardan faqat bittasi orqali ma'lumot uzatilishi mumkin emas.

O'zaro ta'sirga misol:

1. Klinika Medfleks uchinchi tomon va uning ishtirokchisi bo'lmagan har qanday xizmat bilan to'g'ridan-to'g'ri shartnoma tuzadi
2. To'g'ridan-to'g'ri integratsiyani rivojlantirish (yoki imkonsiz bo'lsa) o'rniga, klinika va sherik ma'lumotlar almashish uchun Medflex API-dan foydalanishga kelishib oldilar
3. Klinika Medfleksning shaxsiy kabinetida ochiq token chiqaradi va uni sherik xizmatiga o'tkazadi
4. Hamkor Medflex API-da birlashtirilgan bo'lib, so'rovlarda klinikaning uzatilgan tokenini (yordamdagi sheriklar bo'limi) ko'rsatadi.
5. Agar pullik API usullaridan foydalanish rejalashtirilgan bo'lsa, klinika Medfleksdagi balansni to'ldiradi (mablag ' etishmasa, pullik usullar mavjud bo'lmaydi)
6. Hamkor integratsiyani yakunlaydi va muntazam ravishda Medflex API-ga klinikaning tokenini ko'rsatadigan so'rovlarni yuboradi
7. Medflex pullik API usullari bo'yicha xizmat so'rovlarini kuzatib boradi. Standart litsenziya shartnomasiga muvofiq klinika balansidan pul yechib olinadi

Medfleks klinikasining ochiq tokeni qanday muammolarni hal qiladi

1. Klinika va xizmat to'g'ridan – to'g'ri integratsiyani ishlab chiqishi, sinovdan o'tkazishi va qo'llab-quvvatlashi shart emas-hamma narsa allaqachon Medfleksda, hatto sherik integratsiya do'konida bo'lmasa ham
2. Ba'zi hollarda Medfleksdagi klinikaning ochiq tokeni klinikaning mis bilan integratsiyalashuvning yagona usuli hisoblanadi
3. Klinikada sherik xizmatiga ma'lumotlarni uzatish jarayonining xavfsizligi haqida tashvishlanmaslik kerak

Ochiq token sherigi uchun qanday API usullari guruhlari mavjud

Ommaviy Medflex API spetsifikatsiyasi havolada mavjud - https://developer.medflex.ru/clinic-token/

• Modellar
• Jadval
• Onlayn yozib olish
• Xizmatlar
• Veb-kancalarni sozlash (faqat xizmatlar haqida bildirishnomalar, qabul qilish yo'q)

Ochiq tokendan foydalanish qancha turadi

Muhim! foydalanish narxi va shartlari standart litsenziya shartnomasida ko'rsatilgan.

Klinika sherik-xizmat tomonidan API-ning faqat 2 usulidan foydalanish uchun to'laydi (pul Medfleks balansidan olinadi). Ochiq token API usullari orqali mavjud bo'lgan qolganlardan foydalanish bepul. Pullik usullar:

POST /direct_appointment/doctor/execute/usuli

• Nima uchun: mis klinikasida onlayn yozuv yaratish
• To'lov: muvaffaqiyatli yaratilgan yozuvlar uchun

So'rov opsiyasi bilan Get /models/doctor / usuli«detailed: true»

• Nima uchun: shifokorlar haqida ilg'or ma'lumotlarni olish
• To'lov: kengaytirilgan ma'lumot olgan shifokorlar uchun. Agar sherik shifokorlar haqida ilg'or ma'lumotlarga muhtoj bo'lmasa, u so'rovda ishora «detailed: false»qiladi va klinika bunday so'rov uchun hech narsa to'lamaydi

Kengaytirilgan shifokor ma'lumotlarini so'rashda mavjud bo'lgan parametrlar ro'yxati (so'rov opsiyasi bilan «detailed: true»):

• avatar (shifokor surati ProDoctorov)
• education_and_experience (tajriba va ilmiy daraja haqida ma'lumot)
• reyting (shifokor ProDoctorovreytingi )
• sharhlar (bu qator har doim bo'sh bo'ladi-ba'zi integratsiyalar bilan orqaga qarab muvofiqligi uchun kerak)

Tokenni qanday yaratish kerak

1. Integratsiya do'koniga kiring.

2. Blokning eng pastki «Дополнительные сервисы (оплачиваются клиникой)»qismida bosing «Добавить сервис».

3. Xizmat nomini kiriting.

4. Bosing «Сгенерировать код доступа».

5. Yaratilgan kod-bu belgi. Uni nusxa ko'chiring va birlashtirmoqchi bo'lgan xizmat mutaxassislariga yuboring.

6. Oyna yopilgandan so'ng, xizmat integratsiya ro'yxatida paydo bo'ladi. Integratsiya xizmat uni o'z tomonida amalga oshirganda ishlaydi.

Muhim! Kirish kaliti maxfiy ma'lumotdir. Kalit ochiq kirishni oldini olish uchun uni faqat ishonchli shaxsga o'tkazing.

Agar siz mis-ga xizmatga kirishni vaqtincha cheklashingiz kerak bo'lsa, kartadagi kalit o'rnini o'zgartirish kifoya (u kul rangga aylanishi kerak).

Agar siz xizmat bilan ishlashni to'xtatgan bo'lsangiz va keyinchalik u bilan ishlashni xohlamasangiz, integratsiyani olib tashlash mumkin.