Басқа қызметтермен Интеграция (API + токен)

Мазмұны:

• API дегеніміз не
• API таңбалауышы дегеніміз не және ол не үшін қажет
• В клиникасы шығаратын ашық API таңбалауышы дегеніміз не МедФлекс(ашық токен, клиника таңбалауышы)
• Клиниканың ашық белгісі қандай мәселелерді шешедіМедФлекс
• Ашық таңбалауыш серіктесіне API әдістерінің қандай топтары қол жетімді
• Ашық таңбалауышты пайдалану қанша тұрады
• Таңбалауышты қалай жасауға болады

Интеграция дүкенінде жоқ қызметтермен біріктіру үшін МедФлексжеке кабинетте кіру кілтін (таңбалауышты) жасауға болады. Кілтті сіз біріктіргіңіз келетін қызметтің техникалық мамандарына беру керек.

API дегеніміз не

API (Application Programming Interface) - бұл әртүрлі бағдарламалар мен қызметтердің бір-бірімен өзара әрекеттесуіне мүмкіндік беретін ережелер, хаттамалар мен құралдар жиынтығы.

Қарапайым сөзбен айтқанда, API-бұл «язык общения»әр түрлі ақпараттық жүйелер арасында келісілген, бұл әр түрлі қызметтер бір-бірін түсініп, тиімді ақпарат алмасуы үшін қажет.

API таңбалауышы дегеніміз не және ол не үшін қажет

API таңбалауышы-сұрау бастамашысын аутентификациялау және авторизациялау үшін API сұрауларын бөлісу кезінде қолданылатын бірегей кілт.

Стандартты API таңбалауышы келесідей: cdda9acf1bc5fdd8b148539a5f7a752fabeeecebdd121fe1a946c1e065af04be

Не үшін қолданылады:

• Пайдаланушыны немесе қолданбаны сәйкестендіру-API таңбалауышы сұрау жүйеге таныс, жарамды, сенімді көзден келетінін растайды
• Қол жеткізуді басқару-көрсетілген таңбалауышы бар пайдаланушыға қандай API деректері немесе мүмкіндіктері қолжетімді екенін анықтайды
• Қауіпсіздік - логин мен парольді ауыстырады, тіркелгі деректерінің ағып кету қаупін азайтады
• Сұраныстарды бақылау және шектеу – сервер таңбалауыш белсенділігін бақылай алады және сұраулар санын шектей алады

В клиникасы шығаратын ашық API таңбалауышы дегеніміз не МедФлекс(ашық токен, клиника таңбалауышы)

МедФлекс клиникаға Жеке кабинеттегі интеграция дүкенінде болмаса да, әртүрлі қызметтермен қауіпсіз интеграциялануға мүмкіндік береді МедФлекс. Сондай-ақ, интеграциялау үшін қол жетімді бірқатар серіктестер әдепкі бойынша ашық токен функционалдығын пайдаланады.

Маңызды! Ашық токен бойынша ақпарат клиниканың барлық филиалдары бойынша бірден беріледі, олардың тек біреуі бойынша ақпарат беруге болмайды.

Өзара әрекеттесу мысалы:

1. Клиника үшінші тарап және оның қатысушысы болып табылмайтын қандай да бір сервиспен Тікелей шарт жасасадыМедФлекс
2. Тікелей интеграцияны дамытудың (немесе мүмкін болмаған жағдайда) орнына клиника мен серіктес МедФлексдеректерді бөлісу үшін API қолдануға келісті
3. Клиника Жеке кабинетте ашық токен шығарады МедФлексжәне оны серіктес сервиске береді
4. Серіктес API арқылы біріктіріліп МедФлекс, сұрауларда берілген емхана таңбалауышын (Help-тегі серіктестерге арналған бөлім)көрсетеді
5. МедФлексЕгер ақылы API әдістерін қолдану жоспарланса , Клиника теңгерімді толықтырады (қаражат жетіспеген жағдайда ақылы әдістер қол жетімді болмайды)
6. Серіктес интеграцияны аяқтайды және тұрақты түрде емхана таңбалауышын көрсететін API сұрауларын жасайдыМедФлекс
7. МедФлекс ақылы API әдістері бойынша қызмет сұрауларын қадағалайды. Стандартты лицензиялық шартқа сәйкес клиниканың балансынан ақшалай қаражат алынады

Клиниканың ашық белгісі қандай мәселелерді шешедіМедФлекс

1. Клиника мен қызмет тікелей интеграцияны дамытудың, сынаудың және қолдаудың қажеті жоқМедФлекс-серіктес интеграция дүкенінде болмаса да , бәрі қазірдің өзінде бар
2. Кейбір жағдайларда в клиникасының ашық таңбалауышыМедФлекс-бұл mis клиникасымен интеграцияланудың жалғыз жолы
3. Клиника серіктес сервиске деректерді беру процесінің қауіпсіздігі туралы алаңдамауы мүмкін

Ашық таңбалауыш серіктесіне API әдістерінің қандай топтары қол жетімді

Жалпыға ортақ API МедФлексспецификациясы сілтеме арқылы қол жетімді - https://developer.medflex.ru/clinic-token/

• Модельдер
• Кесте
• Онлайн жазу
• Қызметтер
• Веб-ілмектерді орнату (тек қызметтер туралы хабарламалар, трюктерсіз)

Ашық таңбалауышты пайдалану қанша тұрады

Маңызды! құны мен пайдалану шарттары стандартты лицензиялық шартта көрсетілген.

Клиника серіктес қызметтің тек 2 API әдісін қолданғаны үшін төлейді (ақша баланстан МедФлексалынады ). Ашық таңбалауыш арқылы қол жетімді қалған API әдістерін пайдалану тегін. Ақылы әдістер:

Post /direct_appointment/doctor/execute әдісі/

• Не үшін: МИС клиникасында онлайн жазба жасау
• Төлем: сәтті жасалған жазбалар үшін

Сұрау параметрімен GET /models/doctor/ әдісі«detailed: true»

• Не үшін: дәрігерлер туралы кеңейтілген ақпарат алу
• Төлем: кеңейтілген ақпарат алған дәрігерлер үшін. Егер серіктеске дәрігерлер туралы кеңейтілген ақпарат қажет болмаса, ол сұрауда көрсетеді «detailed: false»және клиника мұндай сұрау үшін ештеңе төлемейді

Дәрігерлердің кеңейтілген ақпаратын сұрағанда қол жетімді параметрлер тізімі (сұрау параметрімен«detailed: true»):

• avatar (дәрігердің суреті ProDoctorov)
• education_and_experience (еңбек өтілі және ғылыми дәрежесі туралы ақпарат)
• рейтинг (дәрігердің ProDoctorovрейтингі )
• шолулар (бұл массив әрқашан бос болады - кейбір интеграциялармен кері үйлесімділік үшін қажет)

Таңбалауышты қалай жасауға болады

1. Интеграция дүкеніне кіріңіз.

2. Блоктың ең төменгі «Дополнительные сервисы (оплачиваются клиникой)»жағында басыңыз «Добавить сервис».

3. Қызмет атауын енгізіңіз.

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

5. Жасалған код-бұл токен. Оны көшіріп, біріктіргіңіз келетін қызмет мамандарына жіберіңіз.

6. Терезені жапқаннан кейін қызмет интеграциялар тізімінде пайда болады. Интеграция қызмет оны өз жағында жүзеге асырған кезде жұмыс істейді.

Маңызды! Кіру кілті құпия ақпарат болып табылады. Кілт ашық қол жетімді болмауы үшін оны тек сенімді адамға беріңіз.

Егер сервистің сіздің МАЖ-ға кіруін уақытша шектеу қажет болса, картадағы ауыстырып-қосқыштың орнын өзгерту жеткілікті (сұр түске айналуы керек).

Егер сіз қызметпен жұмыс істеуді тоқтатсаңыз және онымен болашақта жұмыс істегіңіз келмесе, интеграцияны жоюға болады.