Мундариҷа 
- Ирсоли паемҳо бо назардошти минтақаи вақти бемор
- Ирсоли паемҳо бо назардошти санаи қабул
- Ирсоли паемҳо дар соатҳои корӣ ва фиристодани паемҳо дар шаб, агар мантиқи тиҷорат инро талаб накунад
- Ирсоли паемҳо бо назардошти давомнокии қабул
- Ирсоли паемҳо бо назардошти вазъи қабули Medflex ҳисобшаванда
- Ҳангоми ҷавоб надодан паемҳои эҷод/тағир додани қабулро дубора фиристед
- Коркарди РАМЗҲОИ ПОСУХИ API Medflex
Консепсияи Медфлекси Api
API-И Медфлекс кӯшиш мекунад, ки то ҳадди имкон оддӣ бошад, дар тарафи худ мантиқи ҳадди ақали тиҷоратиро барои интиқоли самаранок, саривақтӣ ва устувори иттилоот байни иштирокчиени ҳамгироӣ дошта бошад.
Парвандаҳои маъмултарин
Ҳангоми иҷозат додан префиксро нишон диҳед Token.
Ирсоли паемҳо бо назардошти минтақаи вақти бемор
Ҳангоми фиристодани огоҳиномаҳо минтақаи ВАҚТИ LPU-ро ба назар гиред.
Барои ин майдонро истифода баред lpu_id.
Барои дархост кардани маълумот дар бораи клиника, қалмоқро истифода баред /catalog/lpu.
Истифодаи майдон lpu_id. шумо метавонед маълумот гиред town_id
Намунаи ҷавоб:
Баъд аз ин, маълумотро аз феҳристи шаҳрҳои мо гиред /catalog/town/, ва бо истифода аз ягон китобхонаи ба шумо мувофиқ, минтақаи ВАҚТИ LPU-ро муайян кунед.
Намунаи ҷавоб:
Ба шарикони api-и триггерӣ (хизматрасониҳои фиристодани триггерӣ) усул дастрас нест /catalog/lpu. Барои гирифтани LPU дастрас аст /appointments/lpu, минтақаи вақт дар майдон нишон дода шудааст time_offset.
Ирсоли паемҳо бо назардошти санаи қабул
Ба шарик тавсия дода мешавад, ки мақом ва санаи қабулро ба назар гирад. Дар баъзе ҳолатҳо, МедФлекс маълумотро аз рӯи усулҳои аллакай анҷомефта интиқол медиҳад.
Барои коркарди сабт ба қалмоқе диққат диҳед /direct_appointment/history/.
Ин хук таърихи сабтҳоро бармегардонад, дар он маълумоти пурраи қабулро пайдо кардан мумкин аст. Аз ҷумла сана ва вақти оғоз ва анҷоми қабул.
Намунаи ҷавоб:
Шарикони триггер API (хидматҳои триггер) ба усул дастрасӣ надоранд /direct_appointments/history. Рӯйхати усулҳои клиникаро бо истифода аз усул ба даст овардан мумкин аст /appointments/appointments/. Ҳангоми дархост параметр нишон дода мешавад dt_start ва duration.
Фиристодани паемҳо дар вақти корӣ ва фиристодани паемҳо дар вақти шабона, агар мантиқи тиҷорат инро талаб накунад
Ҳангоми фиристодан тавсия медиҳем, ки сана ва вақти эҷоди сабтро ба назар гиред, зеро баъзан қабул метавонад шабона ва баъзан рӯзона сохта шавад, аммо бо таъхири муваққатӣ интиқол дода шавад.
Барои гирифтани маълумот дар бораи сана ва вақти эҷоди сабт, шумо метавонед қалмоқро истифода баред /appointments/appointments/.
Намунаи ҷавоб:
Ирсоли паемҳо бо назардошти давомнокии қабул
Тавсия дода мешавад, ки давомнокии қабулро ба назар гиред ва инчунин маълумотро дуруст кор кунед, вақте ки давомнокии қабул ба воқеӣ мувофиқат намекунад (бо сабаби хусусиятҳои равандҳои клиника).
Масалан, давомнокии қабулро 1 дақиқа муайян кардан мумкин аст, аммо давомнокии воқеӣ гуногун аст.
Шумо метавонед бо истифода аз қалмоқ маълумот ҷамъ кунед /direct_appointment/history/.
Шарикони триггер API (хидматҳои триггер) ба усул дастрасӣ надоранд /direct_appointments/history. Рӯйхати усулҳои клиникаро бо истифода аз усул ба даст овардан мумкин аст /appointments/appointments/. Ҳангоми дархост параметр нишон дода мешавад duration.
Ирсоли паемҳо бо назардошти вазъи қабули Medflex ҳисобшаванда
Барои осон кардани кор бо статусҳо, МедФлекс статусҳои ҳисобшавандаро дар тарафи худ нишон медиҳад.
Агар хидмат бояд мақоми МИС-ро ба назар гирад, пас ин маълумот дар майдонҳо мавҷуд аст status ва original_status.
- Майдон status Барои ҳолати сабт, Ки МедФлекс дар тарафи худ тасдиқ мекунад, масъул аст.
- Майдон original_status кадом маълумот дар клиникаи мис, ки дар он сабт шудааст, нигоҳ дошта мешавад. Барои истифодаи ин маълумот, барои коркарди ин майдон дар канори худ каме такмил додан кифоя аст.
Намунаи ҷавоб:
Ҳангоми ҷавоб надодан паемҳои эҷод/тағир додани қабулро дубора фиристед
Агар МедФлекс ба дархости фиристодашуда ҷавоб нагирад (масалан, огоҳинома дар бораи эҷод/тағир додани қабул), дархост дубора фиристода мешавад. Дар ин ҳолат, дар тарафи шарик, дархости аслӣ метавонад бомуваффақият коркард карда шавад, аммо ҷавоб дар доираи таймаутҳо дода намешавад.
Ин метавонад боиси фиристодани паемҳо ба беморон дар бораи эҷод/тағир додани қабул гардад.
Барои пешгирӣ кардани ин, барои усул тавсия дода мешавад POST /appointments/webhooks калиди идемпотентро дар шакли САРЛАВҲАИ HTTP истифода баред Idempotency-Key
, КИ ДАР ХУД UUID-и дархостро дар бар мегирад. Ҳамин тариқ, коркарди дархостҳоро барои ба назар гирифтани ин калид танзим кардан мумкин аст-агар дархости қаблан бомуваффақият қабул ва коркард шуда бошад Idempotency-Key
, пас дархостҳои такрорӣ бо ҳамин Idempotency-Key
бе такрори паемҳо ба бемор бояд нодида гирифта шавад.
Коркарди РАМЗҲОИ ПОСУХИ API Medflex
Муҳим! Ҳангоми таҳияи ҳамгироӣ, ба НАЗАР гиред, КИ API мунтазам нав карда мешавад ва бо хатогиҳои нав илова карда мешавад. Мо тавсия медиҳем, ки коркардкунандагони хатои универсалии иловагӣ бо рамзи 4XX илова кунед.