ABHA интеграција за апликации за телемедицина: V3 API и водич за ABDM

Како да се интегрира ABHA во апликација за телемедицина во 2026 година: повици на V3 API, Aadhaar OTP, проток на согласност, пресвртници од M1 до M3, тестирање во сендбокс и производство на ABDM.

Правен СоманИзвршен директор, Сигософт Ажурирани 11 мин
Постар маж на видео консултација на телефон дома, додека неговата ќерка држи папка со стари медицински извештаи

За да го интегрирате ABHA во апликација за телемедицина, се регистрирате на песочникот на ABDM, добивате токен за пристап до портал и го преземате јавниот клуч на ABDM. Потоа го креирате или потврдувате ABHA на пациентот преку API-јата за запишување и најавување V3, со бројот на Aadhaar и OTP енкриптирани со RSA пред да ги испратите. Тоа ја опфаќа пресвртницата M1 на ABDM. За да споделувате и преземате записи од консултации, ги додавате M2 и M3, а потоа ги поминувате функционалните тестови на NHA и безбедносната ревизија пред да ги добиете продукциските клучеви.

Еве зошто е важно во пракса. Пациент во Кожикоде се приклучува на видео консултација, а докторот бара извештај за HbA1c од минатата година. Без ABHA, пациентот пребарува низ фотографии на WhatsApp додека времето тече. Со поврзан ABHA, пациентот одобрува барање на својот телефон и извештајот се појавува на екранот на докторот. Тој мал момент е она што го градите.

API повиците подолу ги следат V3 API-јата на ABDM, кои ги заменија постарите V1 и V2 текови.

Брз одговор

  • Што е ABHA: 14-цифрен здравствен идентификатор во рамките на Дигиталната мисија Ајушман Бхарат (ABDM), водена од Националниот здравствен орган (NHA)
  • Што прави вашата апликација со неа: креирајте нов ABHA, потврдете го постоечкиот, покажете ја ABHA картичката и поврзете ги записите од консултациите
  • Која пресвртница: Креирањето и верификацијата на ABHA е M1. Споделувањето на записи е M2 (HIP). Преземањето на записи е M3 (HIU)
  • Каде да го изградите: песочникот на ABDM, користејќи V3 API-ја
  • Што ви е потребно за да одите во живо: Функционално тестирање на 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 скенирање или OTP.
  • Клиентите на болницата го бараат тоа
    Болниците и клиниките кои работат со владини шеми сè повеќе очекуваат софтвер подготвен за ABDM.
  • Лекарите добиваат подобар контекст
    Минатите рецепти и извештаи стигнуваат до лекарот со согласност, па затоа консултацијата е пократка и побезбедна.

Ова упатство ги опфаќа обете страни на работата на ABHA: деловниот поглед на ABDM (пресвртници, согласност, сертификација и заштита на податоци) и V3 повиците што ги прават вашите програмери.

Пресвртници за интеграција на ABHA: M1, M2 и M3

ПресвртницаШто прави вашата апликација за телемедицинаУлога на ABDM
M1Креирај ABHA, потврди ABHA, покажи ја ABHA картичката и QR-кодот, прифати скенирање и споделување при регистрацијаУслуги на ABHA
M2Поврзете ја секоја консултација како контекст на грижа и споделувајте записи кога пациентот ќе се согласиДавател на здравствени информации (HIP)
M3Побарајте ги картоните на пациентот од други даватели на здравствени услуги и покажете ги на лекаротКорисник на здравствени информации (HIU)
Дијаграм на пресвртници на ABDM: M1 креирање и верификација на ABHA, M2 споделување на записи како HIP, M3 преземање на записи како HIU

Водичите за интеграција, исто така, опишуваат четврта пресвртница, M4, за дигитални осигурителни барања преку Националната берза за здравствени барања (NHCX). Повеќето апликации за телемедицина не ја имаат потреба од неа при лансирање, но вреди да се планира доколку вашите клиенти се болници кои поднесуваат барања за осигурување ( Nirmitee ).

Започнете со M1 и прво направете го да работи со вистински пациенти. Забележете дека NHA им кажа на корисниците на sandbox на својот форум за програмери дека се потребни најмалку две пресвртници пред да се заврши демо-верзијата со sandbox, затоа испланирајте ги M1 и M2 заедно.

ABHA API интеграција: V3 повиците, чекор по чекор

Основните хостови во песочникот се abhasbx.abdm.gov.in/abha/api за повиците на ABHA и dev.abdm.gov.in за порталот. Продукцијата користи различни хостови и нови акредитиви, кои NHA ги издава по излегувањето од песочникот.

Чекор 1: Добијте пристап до песочник

Аплицирајте на ABDM sandbox со деталите за вашата организација и случајот на употреба (на пример, апликација за телеконсултации). По одобрувањето, добивате ID на клиент и тајна на клиентот. Чувајте ја тајната во менаџер за тајни од првиот ден, а не во вашиот код.

Чекор 2: Добијте токен за пристап до портал

Повикајте го API-то за сесии на порталот со вашиот ID на клиентот и тајната за да добиете токен за носител. Секој подоцнежен повик ги испраќа овие заглавија:

НасловотVrednost
ОвластувањеНосителски токен од API-то за сесии
ИД-БАРАЊЕНов UUID за секое барање
ВРЕМЕНСКИ ВРЕМЕТековно време во ISO 8601 UTC, на пример 2026-10-27T07:30:00.000Z
X-CM-IDsbx во песочникот, abdm во продукција

Токените истекуваат, затоа кеширајте го токенот и освежете го пред да истече, наместо да го повикувате API-то за сесии при секое барање.

Чекор 3: Преземете го јавниот клуч на ABDM

Повикајте GET /v3/profile/public/certificate. ABDM го користи овој клуч за да ги заштити Aadhaar броевите, мобилните броеви и OTP-овите во транзит. Кеширајте го, но освежете го по распоред, бидејќи клучот се ротира.

Чекор 4: Шифрирајте го бројот на Aadhaar

V3 ги отфрла Aadhaar броевите и OTP-овите во обичен текст. Шифрирајте ги со јавниот клуч користејќи 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' },
    Бафер.од(вредност, 'utf8')
  ).toString('base64');
}

Чекор 5: Побарајте го Aadhaar OTP

ПОСТ /v3/запишување/барање/otp

{
  „txnId“: „“,
  „обем“: [„abha-запишете“],
  „Најава совет“: „aadhaar“,
  „ИД за најавување“: „,“
  „otpSystem“: „aadhaar“
}

Одговорот враќа txnId и порака во која се вели дека OTP е испратен на мобилниот број поврзан со Aadhaar на пациентот. Зачувајте го txnId за следниот повик.

Чекор 6: Потврдете го OTP и креирајте го ABHA

ПОСТИ /v3/запишување/запишување/byAadhaar

{
  „authData“: {
    „Методи за авторизација“: [„otp“],
    „otp“: {
      „txnId“: „ „,“
      „otpValue“: „ „,“
      „мобилен“: „ „
    }
  },
  „согласност“: { „код“: „abha-регистрација“, „верзија“: „1.4“ }
}

Доколку мобилниот број што го дава пациентот е различен од неговиот број поврзан со Aadhaar, ABDM ве замолува да го потврдите со втор OTP. Повторно јавете се на /v3/enrollment/request/otp со mobile-verify scope и otpSystem поставени на abdm, а потоа на /v3/enrollment/auth/byAbdm.

Секвенцијален дијаграм на креирање на ABHA: апликацијата добива токен и јавен клуч, испраќа шифриран Aadhaar број, пациентот добива OTP, а 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 повици.

Во М2 и М3, записите никогаш не поминуваат низ централна складиште. Пациентот одлучува, од случај до случај, кој што гледа:

  1. Вашиот лекар, дејствувајќи како Корисник на здравствени информации (HIU), поднесува барање за согласност преку ABDM порталот.
  2. Пациентот го одобрува тоа во својата PHR апликација и избира кои типови записи и кој временски прозорец да ги сподели.
  3. Порталот го известува давателот на услуги што ги чува евиденциите, Давателот на здравствени информации (HIP).
  4. HIP испраќа шифриран FHIR пакет до вашата апликација, која го дешифрира и му го покажува на лекарот.

Од ова произлегуваат две правила. Испраќајте само контексти на грижа и временскиот прозорец што пациентот го одобрил, никогаш целосната историја. И водете ревизорска евиденција за секое барање за согласност, одобрување и пренос на податоци, бидејќи безбедносната ревизија и секое барање за заштита на податоци ќе го бараат тоа.

По телеконсултација, вратете го е-рецептот во евиденцијата на пациентот поврзана со ABHA како нов контекст на нега, за да може пациентот да го види во својата PHR апликација и да го сподели со следниот лекар ( Medical365 ).

Дијаграм на споделување врз основа на согласност: апликацијата на лекарот бара записи, пациентот одобрува во својата PHR апликација, а другата болница испраќа шифрирани записи.

Од ABDM sandbox до продукција

  1. Изградете и тестирајте го M1, потоа M2 или M3, во песочникот.
  2. Положи ги функционалните тестови на NHA за секоја пресвртница.
  3. Добијте ревизија за безбедност на веб-апликации (WASA) од Агенција со персонал од CERT-InБезбедносните компании го нарекуваат резултатот и сертификат „Безбедно за домаќин“.
  4. Демонстрирајте го софтверот на NHA и поднесете го формуларот за излез од sandbox.
  5. Добијте продукциски акредитиви и префрлете се на продукциски домаќини.
  6. Регистрирајте го секој објект во Регистарот на здравствени установи. Сертификацијата го опфаќа софтверот, а не секоја клиника што го користи.
Шест чекори од пристап до ABDM sandbox до производствени клучеви: градење, функционални тестови, безбедносна ревизија, демонстрација на NHA и излез

NHA го ажурира овој процес, затоа потврдете ги тековните чекори на страницата со песок на ABDM пред да планирате датуми.

Чести грешки во интеграцијата со ABHA

  1. Копирање стари упатства
    Многу блог објави, вклучувајќи ја и нашата претходна верзија од оваа, прикажуваат патеки V1 или V2. Само надоградете на V3.
  2. Испраќање обични вредности на Aadhaar или OTP
    V3 очекува вредности шифрирани со RSA. Обичните вредности не успеваат.
  3. Погрешни временски ознаки
    Испратете UTC во ISO 8601 формат и одржувајте го часовникот на вашиот сервер синхронизиран со NTP. Поместувањето на часовникот предизвикува одбиени барања што изгледаат случајно.
  4. „Забранетиот ресурс“ (код 900908)
    Ова обично значи дека вашиот клиентски ID не е претплатен на тоа API. Побарајте од поддршката за интеграција на ABDM да го овозможи, наместо да го менувате вашиот код.
  5. Акредитиви со скриени простори
    Копирањето тајна на клиентот од порталот може да додаде празно место на крајот или нов ред. Скратете го.
  6. Третман на ABDM само како излезен
    M2 и M3 зависат од тоа дали вашите крајни точки за повратен повик се достапни од портата.
  7. Игнорирање на заштитата на податоците
    ABHA тековите обработуваат Aadhaar броеви и здравствени картони. Дневници за согласност за план, енкрипција и престој на податоци во Индија според Закон за DPDP за апликации за здравствена заштита од самиот почеток.

Дизајнирањето на ABHA скрининг кај пациентите всушност завршува

API е само половина од работата. Пациентите ги напуштаат ABHA протоците кога се чувствуваат изгубени. Неколку навики помагаат:

  • Прво прашајте дали пациентот веќе има ABHA и дали по дифолт е најавување, а не креирање.
  • Кажете каде ќе оди OTP-кодот („на мобилниот поврзан со вашиот Aadhaar“) пред да го испратите
  • Понудете малајаламски, хинди, тамилски и други јазици што ги користат вашите пациенти
  • Објаснете ги барањата за согласност со едноставни зборови: кој сака кои записи, за колку долго
  • Дозволете му на пациентот да продолжи со консултацијата ако ABHA не успее и обидете се повторно подоцна.

Како Сигософт гради апликации за телемедицина подготвени за ABHA

Сигософт гради апликации за телемедицина за клиники, болници и здравствени стартапи. Нашата апликација Медицино , на пример, комбинира закажување лекар, видео консултации и испорака на лекови во еден производ. За индиските клиенти, го планираме ABHA во првото издание, а не како подоцнежен додаток.

Во еден проект на ABHA, нашиот тим се справува со:

Доколку планирате нов производ, нашиот водич за градење на MVP за телемедицина без негова реконструкција подоцна објаснува како да оставите простор за ABDM од самиот почеток.

NAJČESTO POSTAVUVANI PRAŠANJA

Што е ABHA интеграција?

Дозволува вашата апликација да креира или потврди ABHA број на пациент и да ги поврзе неговите здравствени картони со него. Во однос на ABDM, ова е пресвртница М1.

Што е ABDM песочникот?

Тоа е тест-окружувањето каде што градите и тестирате функции на ABHA, M2 и M3 пред NHA да издаде акредитиви за производство. Секоја организација започнува таму, без оглед на нејзината големина.

Која верзија на ABHA API треба да ја користам во 2026 година?

Користете ги V3 API-јата. Постарите V1 и V2 текови се застарени, а V3 бара RSA-енкриптирани Aadhaar броеви и OTP-а.

Дали интеграцијата на ABHA е задолжителна за апликациите за телемедицина?

Не постои општо правило дека секоја апликација за телемедицина мора да го интегрира ABHA. Во пракса, болниците и владините програми сè повеќе очекуваат софтвер подготвен за ABDM, па затоа тоа влијае на тоа кои клиенти можете да ги услужувате.

Колку време трае интеграцијата на ABHA?

Само M1 може да се изгради за неколку недели ако вашиот тим го знае „песнбоксот“. Целосниот пат до производство зависи и од функционалното тестирање на NHA, безбедносната ревизија и демото, затоа планирајте во месеци, а не во недели. Интеграторите објавуваат проценки кои се движат од 8 до 12 недели со искусен партнер до 5 до 10 месеци за градење од нула (ИГНЕК). Третирајте ги овие како тврдења на добавувачите, а не како реперни точки.

Дали ми требаат и М2 и М3?

M1 го опфаќа самиот ABHA. За споделување на записи од консултации ви е потребен M2, а за преземање на записи од други даватели на услуги ви е потребен M3. NHA побара најмалку две пресвртници пред излегување од sandbox.

Дали ми е потребен сертифициран партнер за интегрирање на ABHA?

Не, секоја регистрирана организација може да аплицира за пристап до sandbox. Партнер кој работел во sandbox главно ви заштедува време на деталите за V3, повратните повици и подготовката за ревизија.

Планирате интеграција со ABHA?

Кажете ни за вашата апликација, потребните пресвртници и датумот на лансирање. Испратете е-пошта на [email protected] , јавете се на +91 98462 37384 или испратете ги вашите барања , а ние ќе ви одговориме со план за проектот.

Извори

Дали овој напис беше корисен?
Правен Соман
Напишано од

Правен Соман Извршен директор, Сигософт

Технолошки претприемач и стратег за дигитални производи со страст за градење скалабилни софтверски производи и решавање на деловни предизвици од реалниот свет. Ужива во истражување на вештачката интелигенција, новите технологии, стартапите и идеите што ја обликуваат иднината на технологијата.

Поврзете се на LinkedIn →
Дискусија

Започнете ја дискусијата

Прашања или искуства за споделување? Нашиот тим чита и одговара.

Оваа страница користи Akismet за намалување на спамот. Дознајте како се обработуваат вашите податоци за коментари.

Бесплатно · Прво договор за доверливост · 100% IP ваша

Читате доволно? Ајде да го изградиме.

Кажете ни ја идејата. Добијте план за патување, со опсег, временска рамка и цена, во рок од 2 часа.

WhatsApp