Інтэграцыя ABHA для тэлемедыцынскіх праграм: кіраўніцтва па API V3 і ABDM

Як інтэграваць ABHA ў праграму тэлемедыцыны ў 2026 годзе: выклікі API V3, аднаразовы пароль Aadhaar, працэс атрымання згоды, этапы M1-M3, тэставанне ў пясочніцы і вытворчасць ABDM.

Правін СоманГенеральны дырэктар Sigosoft Абноўлены 11 мін чытання
Пажылы мужчына на відэакансультацыі па тэлефоне дома, пакуль яго дачка трымае папку са старымі медыцынскімі справаздачамі.

Каб інтэграваць ABHA ў праграму тэлемедыцыны, вы рэгіструецеся ў пясочніцы ABDM, атрымліваеце токен доступу да шлюза і атрымліваеце адкрыты ключ ABDM. Затым вы ствараеце або правяраеце ABHA пацыента праз API рэгістрацыі і ўваходу V3, пры гэтым нумар Aadhaar і OTP шыфруюцца з дапамогай RSA перад адпраўкай. Гэта ахоплівае этап M1 ABDM. Каб абменьвацца і атрымліваць запісы кансультацый, вы дадаяце M2 і M3, а затым праходзіце функцыянальныя тэсты NHA і аўдыт бяспекі, перш чым атрымаць вытворчыя ключы.

Вось чаму гэта важна на практыцы. Пацыент у Кожыкодэ далучаецца да відэакансультацыі, і лекар просіць справаздачу аб HbA1c за мінулы год. Без ABHA пацыент праглядае фатаграфіі WhatsApp, пакуль гадзіннік ідзе. З падключэннем ABHA пацыент ухваляе запыт на сваім тэлефоне, і справаздача адлюстроўваецца на экране лекара. Гэты маленькі момант - гэта тое, што вы ствараеце.

Прыведзеныя ніжэй выклікі API адпавядаюць API версіі 3 ад ABDM, якія замянілі старыя патокі V1 і V2.

Хуткі адказ

  • Што такое ABHA: 14-значны ідэнтыфікатар здароўя ў рамках лічбавай місіі Ayushman Bharat (ABDM), якая кіруецца Нацыянальным агенцтвам аховы здароўя (NHA)
  • Што ваша праграма робіць з гэтым: стварыць новую ABHA, праверыць існуючую, паказаць картку ABHA і прывязаць запісы кансультацый
  • Якая веха: Стварэнне і праверка ABHA — гэта M1. Абмен запісамі — M2 (HIP). Атрыманне запісаў — M3 (HIU).
  • Дзе вы яго будуеце: пясочніца ABDM з выкарыстаннем API V3
  • Што вам трэба для выхаду ў прамым эфіры: Функцыянальнае тэсціраванне NHA, аўдыт бяспекі, праведзены агенцтвам, упаўнаважаным CERT-In, і прадукцыйныя паўнамоцтвы

Чаму інтэграцыя ABHA мае значэнне для тэлемедыцыны ў 2026 годзе

ABHA больш не з'яўляецца нішавым ідэнтыфікатарам. Міністэрства аховы здароўя паведаміла Лок Сабха , што да 31 ліпеня 2026 года было створана 95.99 крор ідэнтыфікатараў ABHA. На пасяджэнні Рулявой групы місіі ABDM 10 ліпеня 2026 года міністэрства таксама паведаміла пра больш чым 105 крор звязаных медыцынскіх запісаў, 5.33 лакха зарэгістраваных устаноў і 2.72 лакха ўстаноў, якія выкарыстоўваюць праграмнае забеспячэнне з падтрымкай ABDM.

Слупковая дыяграма сукупнай колькасці ідэнтыфікатараў ABHA ў Індыі, якая павялічылася з 14.7 крор у 2021 годзе да 95.99 крор да ліпеня 2026 года

Для тэлемедыцынскага бізнесу гэта змяняе тры рэчы:

  • Пацыенты ўжо маюць ABHA
    Многія з іх атрымалі яго ў дзяржаўным шпіталі або лагеры. Папрасіць іх перадрукаваць свае дадзеныя здаецца марудным, бо дастаткова сканавання QR-кода або аднаразовага пароля.
  • Кліенты бальніцы просяць пра гэта
    Шпіталі і клінікі, якія супрацоўнічаюць з дзяржаўнымі схемамі, усё часцей чакаюць праграмнага забеспячэння, гатовага да ABDM.
  • Лекары атрымліваюць лепшы кантэкст
    Папярэднія рэцэпты і справаздачы даходзяць да лекара са згоды, таму кансультацыя карацейшая і бяспечнейшая.

Гэта кіраўніцтва ахоплівае абодва бакі працы ABHA: бізнес-погляд ABDM (этапы, згода, сертыфікацыя і абарона дадзеных) і звароты па V3, якія робяць вашы распрацоўшчыкі.

Этапы інтэграцыі ABHA: M1, M2 і M3

ВяхаШто робіць ваша праграма для тэлемедыцыныРоля ABDM
M1Стварыце ABHA, праверце ABHA, пакажыце карту ABHA і QR-код, прыміце праграму «Сканаваць і падзяліцца» пры рэгістрацыі.Паслугі ABHA
M2Звязвайце кожную кансультацыю з кантэкстам лячэння і дзяліцеся запісамі, калі пацыент на гэта згодныПастаўшчык медыцынскай інфармацыі (HIP)
M3Запытайце карты пацыента ў іншых пастаўшчыкоў і пакажыце іх лекаруКарыстальнік інфармацыі аб здароўі (HIU)
Дыяграма этапаў ABDM: стварэнне і праверка ABHA M1, абмен запісамі M2 як HIP, атрыманне запісаў M3 як HIU

У кіраўніцтвах па інтэграцыі таксама апісваецца чацвёрты этап, M4, для лічбавых страхавых прэтэнзій праз Нацыянальную біржу прэтэнзій па ахове здароўя (NHCX). Большасць праграм тэлемедыцыны не патрабуюць гэтага пры запуску, але варта гэта запланаваць, калі вашымі кліентамі з'яўляюцца бальніцы, якія падаюць страхавыя прэтэнзіі ( Nirmitee ).

Пачніце з M1 і спачатку прымусьце яго працаваць з рэальнымі пацыентамі. Звярніце ўвагу, што NHA паведаміла карыстальнікам пясочніцы на сваім форуме распрацоўшчыкаў, што перад выхадам з дэманстрацыі пясочніцы неабходна выканаць як мінімум два этапы, таму плануйце M1 і M2 разам.

Інтэграцыя ABHA API: выклікі V3, крок за крокам

Базавымі хостамі ў пясочніцы з'яўляюцца abhasbx.abdm.gov.in/abha/api для выклікаў ABHA і dev.abdm.gov.in для шлюза. У прадукцыйнай версіі выкарыстоўваюцца іншыя хосты і новыя ўліковыя дадзеныя, якія NHA выдае пасля выхаду з пясочніцы.

Крок 1: Атрымайце доступ да пясочніцы

Падайце заяўку ў пясочніцы ABDM , указаўшы рэквізіты вашай арганізацыі і сцэнар выкарыстання (напрыклад, праграма для тэлекансультацый). Пасля адабрэння вы атрымаеце ідэнтыфікатар кліента і сакрэтны значэнне кліента. Захоўвайце сакрэт у менеджары сакрэтаў з першага дня, а не ў сваім кодзе.

Крок 2: Атрыманне токена доступу да шлюза

Каб атрымаць токен-носьбіт, выклічце API сесій шлюза, выкарыстоўваючы свой ідэнтыфікатар кліента і сакрэтны код. Кожны наступны выклік адпраўляе наступныя загалоўкі:

Загаловакзначэнне
аўтарызацыяТокен-носьбіт з API сесій
Ідэнтыфікатар запытуНовы UUID для кожнага запыту
TIMESTAMPБягучы час у фармаце ISO 8601 UTC, напрыклад, 2026-10-27T07:30:00.000Z
X-CM-IDsbx у пясочніцы, abmd у вытворчасці

Тэрмін дзеяння токена мінае, таму захоўвайце токен у кэшы і абнаўляйце яго да заканчэння тэрміну дзеяння, замест таго, каб выклікаць API сесій пры кожным запыце.

Крок 3: Атрымаць адкрыты ключ ABDM

Выклічце GET /v3/profile/public/certificate. ABDM выкарыстоўвае гэты ключ для абароны нумароў Aadhaar, мабільных нумароў і аднаразовых пароляў падчас перадачы. Кэшуйце яго, але абнаўляйце па раскладзе, бо ключ змяняецца.

Крок 4: Зашыфруйце нумар Aadhaar

V3 адхіляе звычайныя тэкставыя лікі Aadhaar і аднаразовыя паролі. Зашыфруйце іх з дапамогай адкрытага ключа з дапамогай RSA з дапаўненнем OAEP (SHA-1, MGF1), якое падтрымка інтэграцыі ABDM апісвае як RSA/ECB/OAEPWithSHA-1AndMGF1Padding. У Node.js:

імпартаваць крыпта з 'node:crypto';

// publicKeyPem: ключ з /v3/profile/public/certificate, абгорнуты як адкрыты ключ PEM
экспартная функцыя encryptForAbdm(значэнне, publicKeyPem) {
  вярнуць crypto.publicEncrypt(
    {ключ: publicKeyPem, запаўненне: crypto.constants.RSA_PKCS1_OAEP_PADDING, oaepHash: 'sha1' },
    Buffer.from(значэнне, 'utf8')
  ).toString('base64');
}

Крок 5: Запытайце аднаразовы пароль Aadhaar

POST /v3/рэгістрацыя/запыт/OTP

{
  «Ідэнтыфікатар txn»: «»,
  «абсяг»: [«абха-рэгістрацыя»],
  “loginHint”: “aadhaar”,
  «Ідэнтыфікатар уваходу»: « ”,
  «otpSystem»: «aadhaar»
}

У адказ вяртаецца txnId і паведамленне аб тым, што аднаразовы пароль быў адпраўлены на нумар мабільнага тэлефона, звязаны з Aadhaar пацыента. Захавайце txnId для наступнага званка.

Крок 6: Праверце аднаразовы пароль і стварыце ABHA

POST /v3/enrollment/enrol/byAadhaar

{
  «Даныя аўтарызацыі»: {
    «Метады аўтэнтыфікацыі»: [«адказная пара»],
    «адказная пара»: {
      «Ідэнтыфікатар txn»: « ”,
      «Значэнне otp»: « ”,
      «мабільны»: « «
    }
  },
  «згода»: { «код»: «рэгістрацыя abha», «версія»: «1.4» }
}

Калі нумар мабільнага тэлефона, які падае пацыент, адрозніваецца ад нумара, прывязанага да Aadhaar, ABDM папросіць вас пацвердзіць яго з дапамогай другога аднаразовага пароля. Зноў выклічце /v3/enrollment/request/otp, усталяваўшы дыяпазон mobile-verify і otpSystem на abdm, а затым /v3/enrollment/auth/byAbdm.

Дыяграма паслядоўнасці стварэння ABHA: праграма атрымлівае токен і адкрыты ключ, адпраўляе зашыфраваны нумар Aadhaar, пацыент атрымлівае аднаразовы пароль, а ABDM вяртае профіль ABHA.

Крок 7: Дазвольце існуючым уладальнікам ABHA ўвайсці ў сістэму

Большасць вашых пацыентаў ужо маюць ABHA. Для іх выкарыстоўвайце працэс уваходу замест рэгістрацыі: /v3/profile/login/request/otp, затым /v3/profile/login/verify. Пацыенты могуць увайсці, выкарыстоўваючы свой нумар ABHA або нумар мабільнага тэлефона.

Крок 8: Пакажыце карту ABHA і прыміце опцыю «Сканаваць і падзяліцца».

Пасля стварэння або ўваходу ў сістэму пакажыце пацыенту яго картку ABHA (/v3/profile/account/abha-card) і QR-код (/v3/profile/account/qrCode). Для клінік, якія таксама прымаюць пацыентаў без папярэдняга запісу, падтрымайце функцыю «Сканіраванне і абмен», калі пацыент скануе QR-код вашай установы, і яго дадзеныя трапляюць на экран рэгістрацыі. Міністэрства паведамляе, што на сённяшні дзень было згенеравана амаль 24 крор токенаў «Сканіраванне і рэгістрацыя», таму пацыенты да гэтага прызвычаіліся.

Пасля таго, як M1 спрацоўвае, кожная тэлекансультацыя становіцца кантэкстам догляду, звязаным з ABHA пацыента. Калі іншы пастаўшчык паслуг запытвае згоду пацыента, ваша праграма адпраўляе запісы ў выглядзе зашыфраванага пакета FHIR. Для M3 ваш лекар падае запыт на згоду, пацыент сцвярджае яго ў сваёй праграме PHR, і запісы паступаюць у вашу праграму.

Адно змяненне ў V3 закранае многія каманды: шлюз зваротна выклікае ваш сервер. У V3 выяўленне пацыентаў сінхроннае , і ўсе зваротныя выклікі паступаюць на адзін URL-адрас моста, прычым загаловак X-HIP-ID паказвае, для якой установы прызначаны запыт. Вашаму бэкенду патрэбныя публічныя, надзейныя канчатковыя кропкі зваротных выклікаў, а не толькі выходныя выклікі API.

У M2 і M3 запісы ніколі не праходзяць праз цэнтральнае сховішча. Пацыент сам вырашае, хто што бачыць, у кожным канкрэтным выпадку:

  1. Ваш лекар, які дзейнічае як карыстальнік медыцынскай інфармацыі (HIU), падае запыт на згоду праз шлюз ABDM.
  2. Пацыент сцвярджае гэта ў сваім дадатку PHR і выбірае, якімі тыпамі запісаў і якім часовым акном падзяліцца.
  3. Шлюз паведамляе пастаўшчыку, які захоўвае запісы, — пастаўшчыку інфармацыі аб здароўі (HIP).
  4. HIP адпраўляе зашыфраваны пакет FHIR у вашу праграму, якая расшыфроўвае яго і паказвае лекару.

З гэтага вынікаюць два правілы. Адпраўляйце толькі кантэксты лячэння і часовы інтэрвал, які ўхваліў пацыент, ніколі не поўную гісторыю. І захоўвайце журнал аўдыту кожнага запыту на згоду, зацвярджэння і перадачы дадзеных, бо аўдыт бяспекі і любы запыт па абароне дадзеных будуць шукаць гэта.

Пасля тэлекансультацыі перанясіце электронны рэцэпт назад у запісы пацыента, звязаныя з ABHA, у якасці новага кантэксту лячэння, каб пацыент мог бачыць яго ў сваім дадатку PHR і дзяліцца ім з наступным лекарам ( Medical365 ).

Дыяграма абмену на аснове згоды: праграма лекара запытвае запісы, пацыент згаджаецца ў сваёй праграме PHR, а іншая бальніца адпраўляе зашыфраваныя запісы.

Ад пясочніцы ABDM да вытворчасці

  1. Збярыце і пратэстуйце M1, затым M2 або M3 у пясочніцы.
  2. Прайсці функцыянальныя тэставыя выпадкі NHA для кожнага этапу.
  3. Атрымайце аўдыт бяспекі вэб-прыкладанняў (WASA) ад CERT-In уключанае агенцтваБяспечныя фірмы таксама называюць вынік сертыфікатам бяспечнага размяшчэння.
  4. Прадэманструйце праграмнае забеспячэнне для NHA і адпраўце форму выхаду з пясочніцы.
  5. Атрыманне ўліковых дадзеных для прадукцыйных сістэм і пераключэнне на прадукцыйныя хосты.
  6. Зарэгіструйце кожную ўстанову ў Рэестры ўстаноў аховы здароўя. Сертыфікацыя распаўсюджваецца на праграмнае забеспячэнне, а не на кожную клініку, якая яго выкарыстоўвае.
Шэсць крокаў ад доступу да пясочніцы ABDM да прадукцыйных ключоў: зборка, функцыянальныя тэсты, аўдыт бяспекі, дэманстрацыя NHA і выхад

NHA абнаўляе гэты працэс, таму праверце бягучыя крокі на сайце пясочніцы ABDM, перш чым планаваць даты.

Тыповыя памылкі інтэграцыі ABHA

  1. Капіраванне старых падручнікаў
    У многіх паведамленнях у блогу, у тым ліку ў нашай папярэдняй версіі гэтага, паказаны шляхі V1 або V2. Збірайце толькі на V3.
  2. Адпраўка простых значэнняў Aadhaar або OTP
    V3 чакае значэнні, зашыфраваныя з дапамогай RSA. Звычайныя значэнні не атрымліваюцца.
  3. Няправільныя меткі часу
    Адпраўляйце UTC у фармаце ISO 8601 і сінхранізуйце гадзіннік сервера з NTP. Змена гадзінніка прыводзіць да адхілення запытаў, якія выглядаюць выпадковымі.
  4. «Рэсурс забаронены» (код 900908)
    Звычайна гэта азначае, што ваш ідэнтыфікатар кліента не падпісаны на гэты API. Замест таго, каб змяняць код, звярніцеся ў службу падтрымкі інтэграцыі ABDM, каб уключыць яго.
  5. Паўнамоцтвы са схаванымі прабеламі
    Капіраванне сакрэтнага кода кліента з партала можа дадаць прабел або сімвал новага радка. Абрэжце яго.
  6. Апрацоўка ABDM толькі як выходнага
    M2 і M3 залежаць ад таго, ці даступныя канчатковыя кропкі зваротнага выкліку са шлюза.
  7. Ігнараванне абароны дадзеных
    Патокі ABHA апрацоўваюць нумары Aadhaar і медыцынскія запісы. Плануйце журналы згоды, шыфраванне і захоўванне індыйскіх дадзеных у адпаведнасці з Закон DPDP для праграм аховы здароўя з самага пачатку.

Распрацоўка экранаў ABHA, якія пацыенты сапраўды завяршаюць

API — гэта толькі палова справы. Пацыенты адмаўляюцца ад ABHA-працэдур, калі адчуваюць сябе згубленымі. Некалькі звычак дапамогуць:

  • Спачатку спытайце, ці ёсць у пацыента ўжо ABHA, і па змаўчанні ўвайдзіце ў сістэму, а не стварыце яе.
  • Паведаміце, куды аднаразовы пароль будзе адпраўлены («на мабільны тэлефон, звязаны з вашым Aadhaar»), перш чым адправіць яго
  • Прапануйце малаялам, хіндзі, тамільскую і іншыя мовы, якімі карыстаюцца вашы пацыенты
  • Растлумачце запыты на згоду простымі словамі: хто хоча якія запісы і на які тэрмін
  • Дазвольце пацыенту працягнуць кансультацыю, калі ABHA не атрымаецца, і паспрабуйце пазней.

Як Sigosoft стварае праграмы для тэлемедыцыны, гатовыя да ABHA

Sigosoft распрацоўвае праграмы для тэлемедыцыны для клінік, бальніц і стартапаў у галіне аховы здароўя. Напрыклад, наша праграма Medicino аб'ядноўвае запіс на прыём да лекара, відэакансультацыі і дастаўку лекаў у адным прадукце. Для індыйскіх кліентаў мы плануем уключыць ABHA ў першы рэліз, а не як пазнейшае дапаўненне.

У праекце ABHA наша каманда займаецца:

Калі вы плануеце новы прадукт, наш дапаможнік па стварэнні MVP для тэлемедыцыны без яго наступнай перабудовы тлумачыць, як пакінуць месца для ABDM з самага пачатку.

Часта задаваныя пытанні

Што такое інтэграцыя ABHA?

Гэта дазваляе вашай праграме ствараць або правяраць нумар ABHA пацыента і прывязваць да яго яго медыцынскія запісы. У тэрміналогіі ABDM гэта этап M1.

Што такое пясочніца ABDM?

Гэта тэставае асяроддзе, дзе вы ствараеце і тэстуеце функцыі ABHA, M2 і M3, перш чым NHA выдасць прадукцыйныя паўнамоцтвы. Кожная арганізацыя, незалежна ад яе памеру, пачынае з гэтага.

Якую версію ABHA API мне варта выкарыстоўваць у 2026 годзе?

Выкарыстоўвайце API V3. Старыя патокі V1 і V2 з'яўляюцца састарэлымі, а V3 патрабуе нумароў Aadhaar і аднаразовых пароляў з шыфраваннем RSA.

Ці абавязковая інтэграцыя ABHA для праграм тэлемедыцыны?

Няма агульнага правіла, што кожнае прыкладанне для тэлемедыцыны павінна інтэграваць ABHA. На практыцы бальніцы і дзяржаўныя праграмы ўсё часцей патрабуюць праграмнага забеспячэння, гатовага да ABDM, таму гэта ўплывае на тое, якіх кліентаў вы можаце абслугоўваць.

Колькі часу займае інтэграцыя ABHA?

Толькі M1 можна пабудаваць за некалькі тыдняў, калі ваша каманда ведае "пясочніцу". Поўны шлях да прадукцыйнай версіі таксама залежыць ад функцыянальнага тэсціравання NHA, аўдыту бяспекі і дэманстрацыі, таму плануйце на месяцы, а не на тыдні. Інтэгратары публікуюць ацэнкі ад 8 да 12 тыдняў з вопытным партнёрам да 5-10 месяцаў для зборкі з нуля.ІГНЕК). Разглядайце гэта як заявы пастаўшчыка, а не як эталонныя паказчыкі.

Ці патрэбныя мне таксама М2 і М3?

M1 ахоплівае саму ABHA. Для абмену запісамі кансультацый вам патрэбны M2, а для атрымання запісаў ад іншых пастаўшчыкоў — M3. NHA запатрабавала выканання як мінімум двух этапаў перад выхадам з пясочніцы.

Ці патрэбен мне сертыфікаваны партнёр для інтэграцыі ABHA?

Не, любая зарэгістраваная арганізацыя можа падаць заяўку на доступ да пясочніцы. Партнёр, які працаваў у пясочніцы, у асноўным эканоміць ваш час на дэталізацыі V3, зваротныя званкі і падрыхтоўку да аўдыту.

Плануеце інтэграцыю ABHA?

Раскажыце нам пра сваё прыкладанне, неабходныя этапы і дату запуску. Напішыце нам на адрас электроннай пошты [email protected] , патэлефануйце па нумары +91 98462 37384 або дашліце свае патрабаванні , і мы адкажам вам з дарожнай картай праекта.

крыніцы

Ці быў гэты артыкул карысным?
Правін Соман
аўтар

Правін Соман Генеральны дырэктар Sigosoft

Тэхналагічны прадпрымальнік і спецыяліст па лічбавых прадуктах, які захапляецца стварэннем маштабуемых праграмных прадуктаў і вырашэннем рэальных бізнес-задач. З задавальненнем вывучае штучны інтэлект, новыя тэхналогіі, стартапы і ідэі, якія фарміруюць будучыню тэхналогій.

Падключыцеся да LinkedIn →
Абмеркаванне

Пачніце абмеркаванне

Пытанні ці ёсць вопыт, якім хочаце падзяліцца? Наша каманда чытае і адказвае.

Гэты сайт выкарыстоўвае Akismet для барацьбы са спамам. Даведайцеся, як апрацоўваюцца дадзеныя вашых каментарыяў.

Бясплатна · Пагадненне аб неразгалошванні · 100% ваша інтэлектуальная ўласнасць

Дастаткова чыталі? Давайце пабудуем.

Раскажыце нам пра ідэю. Атрымайце план з аб'ёмам, тэрмінамі і коштам на працягу 2 гадзін.

WhatsApp