Мазмуну 
- Пациенттин убакыт алкагын эске алуу менен билдирүүлөрдү жөнөтүү
- Кабыл алуу күнүн эске алуу менен билдирүүлөрдү жөнөтүү
- Бизнес логикасы талап кылбаса, жумуш убактысында билдирүүлөрдү жөнөтүү жана түнкүсүн билдирүүлөрдү жөнөтпөө
- Кабыл алуу узактыгын эске алуу менен билдирүүлөрдү жөнөтүү
- Эсептелген маалыматтарды кабыл алуу статустарын эске алуу менен МедФлекс
- Жооп жок болгондо кабыл алууну түзүү/өзгөртүү жөнүндө билдирүүлөрдү кайра жөнөтүү
- Жооп коддорун иштеп чыгуу, МедФлекс
Концепция API МедФлекс
API МедФлекс интеграциянын катышуучуларынын ортосунда маалыматты натыйжалуу, өз убагында жана туруктуу берүү максатында минималдуу зарыл болгон бизнес логикасы менен мүмкүн болушунча жөнөкөй болууга умтулат.
Эң көп кездешкен учурлар
Авторизациялоодо префикс бериңиз Token.
Пациенттин убакыт алкагын эске алуу менен билдирүүлөрдү жөнөтүү
Эскертмелерди жөнөтүүдө ЛПУНУН убакыт алкагын эске алыңыз.
Бул үчүн талааны колдонуңуз lpu_id.
Клиника жөнүндө маалымат алуу үчүн илгичти колдонуңуз /catalog/lpu.
Талааны колдонуу lpu_id. сиз маалымат ала аласыз town_id
Мисал жооп:
Андан кийин, биздин шаар каталогунан маалыматтарды чогултуу /catalog/town/. жана каалаган китепкананы колдонуп, лпунун убакыт алкагын аныктаңыз.
Мисал жооп:
Өнөктөштөргө триггер с (триггер почта кызматтары) жеткиликтүү эмес ыкмасы /catalog/lpu. ЛПУНУ алуу үчүн жеткиликтүү /appointments/lpu. убакыт алкагы талаада көрсөтүлгөн time_offset.
Кабыл алуу күнүн эске алуу менен билдирүүлөрдү жөнөтүү
Өнөктөшкө кабыл алуу статусун жана датасын эске алуу сунушталат. Айрым учурларда МедФлекс аяктаган кабылдоолор боюнча маалыматтарды өткөрүп берет.
Жазууну иштетүү үчүн илгичке көңүл буруңуз /direct_appointment/history/.
Бул илгич жазуулардын тарыхын кайтарат, анда кабыл алуу жөнүндө толук маалымат берилет. Анын ичинде кабыл алуу башталган жана аяктаган күнү жана убактысы.
Мисал жооп:
Триггердик өнөктөштөр поп (триггер почта кызматтары) ыкмага мүмкүнчүлүк жок /direct_appointments/history. Клиниканын дайындоолорунун тизмесин төмөнкү ыкма менен алууга болот /appointments/appointments/. Суралганда параметр көрсөтүлөт dt_start жана duration.
Жумуш убактысында билдирүүлөрдү жөнөтүү жана бизнес логикасы талап кылбаса, түнкү билдирүүлөрдү жөнөтпөө
Жөнөтүүдө жазууну жараткан күндү жана убакытты эске алууну сунуштайбыз, анткени кээде кабыл алуу түнкүсүн, кээде күндүз түзүлөт, бирок убакыт кечигүү менен берилет.
Жазууну жараткан күнү жана убактысы жөнүндө маалымат алуу үчүн, илгичти колдонсоңуз болот /appointments/appointments/.
Мисал жооп:
Кабыл алуу узактыгын эске алуу менен билдирүүлөрдү жөнөтүү
Кабыл алуунун узактыгын эске алуу, ошондой эле кабыл алуунун узактыгы реалдуу эмес болгондо маалыматтарды туура иштетүү сунушталат (клиниканын процесстеринин өзгөчөлүктөрүнө байланыштуу).
Мисалы, кабыл алуу узактыгы 1 мүнөт берилиши мүмкүн, бирок иш жүзүндөгү узактыгы башка.
Сиз илгичти колдонуп маалыматтарды чогулта аласыз /direct_appointment/history/.
Триггердик өнөктөштөр поп (триггер почта кызматтары) ыкмага мүмкүнчүлүк жок /direct_appointments/history. Клиниканын дайындоолорунун тизмесин төмөнкү ыкма менен алууга болот /appointments/appointments/. Суралганда параметр көрсөтүлөт duration.
Эсептелген маалыматтарды кабыл алуу статустарын эске алуу менен МедФлекс
Статустар менен иштөөнү жеңилдетүү үчүн МедФлекс эсептелген статустарды өз тарабында көрсөтөт.
Эгер кызмат МИснин статустарын эске алышы керек болсо, анда бул маалымат талааларда камтылган status жана original_status.
- Талаа status жазуунун абалы үчүн жооптуу МедФлекс өз тарабында текшерет.
- Талаа original_status - кандай маалымат жазылган клиниканын МИсинде сакталат. Бул маалыматты колдонуу үчүн, бул талааны иштетүү үчүн сиз тарапта бир аз тактоо жетиштүү.
Мисал жооп:
Жооп жок болгондо кабыл алууну түзүү/өзгөртүү жөнүндө билдирүүлөрдү кайра жөнөтүү
Эгерде МедФлекс берилген сурамга жооп албайт (мисалы, кабыл алууну түзүү/өзгөртүү жөнүндө билдирүү), сурам кайрадан жөнөтүлөт. Мында өнөктөш тарапта иш жүзүндө алгачкы суроо-талап ийгиликтүү иштелип чыгышы мүмкүн, бирок жооп таймаут чегинде берилбейт.
Бул пациенттерге кабыл алууну түзүү/өзгөртүү жөнүндө билдирүүлөрдү кайра жөнөтүүгө алып келиши мүмкүн.
Буга жол бербөө үчүн, бул ыкма үчүн сунушталат POST /appointments/webhooks ИДЕМПОТЕНТ ачкычын орнотулган аталыш түрүндө колдонуңуз Idempotency-Key
, анда камтылган сурамды камтыйт. Ошентип, бул ачкычты эске алуу үчүн сурамдарды иштетүүнү конфигурациялоого болот — эгер суроо мурда ийгиликтүү кабыл алынып, иштетилген болсо Idempotency-Key
. анда ошол эле суроо-талаптарды кайталаңыз Idempotency-Key
оорулууга билдирүүлөрдү кайталабастан, көңүл бурбоо керек.
Жооп коддорун иштеп чыгуу, МедФлекс
Маанилүү! Интеграцияны иштеп чыгууда муну эске АЛЫҢЫЗС дайыма жаңыланып турат жана каталардын жаңы түрлөрү менен толукталат. Код менен кошумча универсалдуу ката иштетүүчүлөрдү кошууну сунуштайбыз 4ч.