Мазмұны 
Интеграция қалай жұмыс істейді
Негізгі жол-Medrocket платформасының бірыңғай анықтамалығы арқылы қызметті іздеу: сіз қызметті жалпы жіктеуіш бойынша табасыз, нақты филиалдар мен ішкі қызмет пен дәрігер идентификаторларын аласыз, содан кейін оларды кесте мен жазбада қолданасыз.
Идентификаторлар тек олардың нысан түріне ғана тән. Бірыңғай анықтамалықтағы бірдей сандық id мәні және белгілі бір Филиалдағы id қызметтері әртүрлі нысандар болып табылады.
API әдістері
Анықтамалықтар
- Get /models/town/ қалаларының тізімін алыңыз — сіздің еліңіз бойынша сүзілген қалалар. Интеграцияға кіру нүктесі: осы жерден сіз қызметтерді іздеу үшін town_id аласыз.
- GET /models/region / аймақтарының тізімін алыңыз.
- Қол жетімді филиалдардың тізімін алыңыз GET /models/lpu/ — қала, мамандық, бағаның болуы және басқа белгілер бойынша сүзгілермен.
- Қол жетімді GET /models/lpu_group/филиал топтарының тізімін алыңыз.
- Филиалдарды іздеу кезінде гео — сүзгілер үшін GET /models/district/, get /models/metro/ МЕТРО желілерінің тізімін және GET /models/metro_line/-МЕТРО желілерінің тізімін алыңыз.
- GET /models/speciality / мамандықтарының тізімін алыңыз.
- GET /models/doctor / кестесі бар дәрігерлер тізімін алыңыз-бірыңғай модель дәрігерлерінің анықтамалығы.
Қызметтерді іздеу
- GET /uni/services / қызметтерінің тізімін алыңыз-санаттары бар бірыңғай анықтамалық қызметтер. Жауап 24 сағатқа кэштеледі; анықтамалықта қызметтің болуы дәл қазір оның бос слоттары бар екеніне кепілдік бермейді.
- Get /uni/services/{uni_service_id}/lpus/ қызметін көрсететін филиалдардың тізімін алыңыз — бұл қызмет және бос слоттар бар қаладағы филиалдар. Жауапта сіз келесі қадам үшін нақты orig_service_id аласыз.
Кесте
- Алдағы 30 күн ішінде POST /schedule/services/ — нақты қызметтер мен филиалдар бойынша бос слоттар қызметтерінің кестесін алыңыз.
Mis-тен түпнұсқа анықтамалық
МИС-клиниканың медициналық ақпараттық жүйесі.
- GET /orig/doctors / дәрігерлерінің тізімін алыңыз-mis филиалының дәрігерлері, бірыңғай анықтамалықта сәйкестендірумен.
Жазу, жою және тарих
- Post /direct_appointment/service/execute / қызметіне онлайн жазба жасаңыз.
- Post /direct_appointment/service/cancel / қызметіне онлайн жазуды болдырмау.
- Get /direct_appointment/history / онлайн жазбалар тарихын алыңыз-сіздің таңбалауышыңыз арқылы жасалған соңғы 45 күндегі жазбалар.
Іскерлік жағдайлар
Маңызды: анықтамалықтарда дәрігердің алдын-ала кеңесін қажет ететін қызметтер жоқ - мұндай қызметтерге онлайн-жазбалар жасау мүмкін емес
Іс 1. Қажетті қызметті қай филиалдан іздеу керектігі туралы түсінік жоқ
Бұл негізгі сценарий: сіз науқасты белгілі бір клиниканың Прейскурантына емес, қызметтердің жалпы каталогына бағыттайсыз.
- Әдіспен қалалар тізімін алыңыз сұраңыз
town_id
дұрыс қала . - Қызметтер тізімін алу әдісімен бірыңғай анықтамалықта қажетті қызметті сұраңыз (біз бұл деректерді өз тарапымызда кэштеуді және күніне бір рет жаңартуды ұсынамыз)
- Қызмет көрсететін филиалдардың тізімін алу әдісі бойынша сұрауда бұрын алынғандарды көрсетіңіз
uni_service_id
жәнеtown_id
қызмет жазуға болатын филиалдарды сұрау үшін. Жауапта Сіз аласызlpu_id
жәнеorig_service_id
. - Қызмет кестесін алу әдісімен бос слоттарды және қажет болған жағдайда нақты дәрігерді нақтылаңыз .
- Қызметке онлайн жазба жасау әдісімен таңдалған жазбаларды жіберу арқылы жазба жасаңыз
lpu_id
,orig_service_id
. науқастың уақыты мен деректері.
Іс 2. Филиал мен қызмет бұрыннан белгілі
Егер lpu_id
және orig_service_id
сізде бұрыннан бар — мысалы, өткен апелляциядан сақталған-бірінші сценарийден 1-3 қадамдарды өткізіп жіберіп, кесте мен жазбаға бірден өтуге болады:
- Қызмет кестесін алу әдісімен бос слоттарды және қажет болған жағдайда нақты дәрігерді нақтылаңыз .
- Қызметке онлайн жазба жасау әдісімен таңдалған жазбаларды жіберу арқылы жазба жасаңыз
lpu_id
,orig_service_id
. науқастың уақыты мен деректері.
Іс 3. Жазбадан бас тарту керек
- Егер
uuid
жазбалар сақталды, содан кейін сіз Қызметке онлайн жазуды жою әдісі бойынша бірден сұрау жасай аласыз. - Егер
uuid
жазба жоқ-пациенттің телефонына және (немесе) күндер ауқымына сүзгілеу арқылы онлайн жазбалар тарихын алу әдісімен жазбаны табыңыз.
Жиі сұрақтар
API-ге кіру үшін таңбалауышты қалай алуға болады?
Сіздің сұранысыңыз бойынша интеграцияны әзірлеу және тестілеу таңбалауышын серіктестермен жұмыс жөніндегі менеджер МедРокет жібереді. Осы токен бойынша әзірлеу және тестілеу үшін тек сынақ клиникасының деректеріне қол жеткізуге болады. Даму аяқталғаннан кейін сіздің негізгі oz таңбалауышыңыз ауыстырылады және онымен бірге дәрігерге және Қызметке жазбалар жасауға болады.
Жазу кезінде дәрігерді көрсету керек пе?
Жоқ. Егер дәрігер көрсетілмесе, оны клиника өзі тағайындайды.
Қызмет анықтамалығын бір рет алуға бола ма және пациент келген сайын оны сұрамауға бола ма?
Ия, біз 24 сағатқа кэштеуді ұсынамыз. Сонымен қатар, нақты слоттардың қол жетімділігі бөлек тексерілуі керек: анықтамалықта қызметтің болуы жазуға арналған бос слоттар бар дегенді білдірмейді.
Қызмет көрсету кестесінде 30 күндік шектеу нені білдіреді?
Бір кесте сұрауы ағымдағы күннен бастап 30 күннен асатын кезеңді қамтуы мүмкін емес.
Жазбаны жасау туралы сұраныс жауапсыз қалды — оны қауіпсіз түрде қайталауға бола ма?
Сұрауды қайталамас бұрын пациенттің телефонындағы жазбалардың тарихын тексеріңіз: егер жазба бұрыннан жасалған болса, қайта жіберу қатеге немесе артық жазбаға әкелуі мүмкін.
Әрбір API сұрауы тарифтеледі ме?
Жоқ, тек сіздің келісімшартыңыздың талаптарына сәйкес жазбаны құруға арналған әрбір сәтті сұраныс тарифтеледі.
Қалалар анықтамалығында дұрыс қала жоқ - не істеу керек?
Нұсқаулық сіздің еліңіз бойынша сүзілген. Егер қала жеткіліксіз болса, Medroket серіктестерінің жұмыс менеджеріне хабарласыңыз.