За да го интегрирате 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
Многу од нив добија еден во државна болница или камп. Барањето од нив повторно да ги внесат своите податоци е бавно кога би било доволно QR скенирање или OTP. - Клиентите на болницата го бараат тоа
Болниците и клиниките кои работат со владини шеми сè повеќе очекуваат софтвер подготвен за ABDM. - Лекарите добиваат подобар контекст
Минатите рецепти и извештаи стигнуваат до лекарот со согласност, па затоа консултацијата е пократка и побезбедна.
Ова упатство ги опфаќа обете страни на работата на ABHA: деловниот поглед на ABDM (пресвртници, согласност, сертификација и заштита на податоци) и V3 повиците што ги прават вашите програмери.
Пресвртници за интеграција на ABHA: M1, M2 и M3
| Пресвртница | Што прави вашата апликација за телемедицина | Улога на ABDM |
|---|---|---|
| M1 | Креирај ABHA, потврди ABHA, покажи ја ABHA картичката и QR-кодот, прифати скенирање и споделување при регистрација | Услуги на 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-ID | sbx во песочникот, 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.

Чекор 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 милиони токени за „Скенирај и регистрирај“, така што пациентите се навикнати на тоа.
Чекор 9: Поврзување на консултации и преземање на записи (M2 и M3)
Откако M1 ќе профункционира, секоја телеконсултација станува контекст на грижа поврзана со ABHA на пациентот. Кога друг давател на услуги ќе побара согласност од пациентот, вашата апликација ги испраќа записите како шифриран FHIR пакет. За M3, вашиот лекар поднесува барање за согласност, пациентот го одобрува во својата PHR апликација, а записите пристигнуваат во вашата апликација.
Една промена во V3 ги фаќа многу тимови: портата го повикува вашиот сервер назад. Во V3, откривањето на пациенти е синхроно и сите повратни повици пристигнуваат на една URL-адреса на мостот, при што заглавието X-HIP-ID ви кажува за кој објект е барањето. На вашиот бекенд му се потребни јавни, сигурни крајни точки за повратни повици, а не само излезни API повици.
Како функционира протокот на согласност
Во М2 и М3, записите никогаш не поминуваат низ централна складиште. Пациентот одлучува, од случај до случај, кој што гледа:
- Вашиот лекар, дејствувајќи како Корисник на здравствени информации (HIU), поднесува барање за согласност преку ABDM порталот.
- Пациентот го одобрува тоа во својата PHR апликација и избира кои типови записи и кој временски прозорец да ги сподели.
- Порталот го известува давателот на услуги што ги чува евиденциите, Давателот на здравствени информации (HIP).
- HIP испраќа шифриран FHIR пакет до вашата апликација, која го дешифрира и му го покажува на лекарот.
Од ова произлегуваат две правила. Испраќајте само контексти на грижа и временскиот прозорец што пациентот го одобрил, никогаш целосната историја. И водете ревизорска евиденција за секое барање за согласност, одобрување и пренос на податоци, бидејќи безбедносната ревизија и секое барање за заштита на податоци ќе го бараат тоа.
По телеконсултација, вратете го е-рецептот во евиденцијата на пациентот поврзана со ABHA како нов контекст на нега, за да може пациентот да го види во својата PHR апликација и да го сподели со следниот лекар ( Medical365 ).

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

NHA го ажурира овој процес, затоа потврдете ги тековните чекори на страницата со песок на ABDM пред да планирате датуми.
Чести грешки во интеграцијата со ABHA
- Копирање стари упатства
Многу блог објави, вклучувајќи ја и нашата претходна верзија од оваа, прикажуваат патеки V1 или V2. Само надоградете на V3. - Испраќање обични вредности на Aadhaar или OTP
V3 очекува вредности шифрирани со RSA. Обичните вредности не успеваат. - Погрешни временски ознаки
Испратете UTC во ISO 8601 формат и одржувајте го часовникот на вашиот сервер синхронизиран со NTP. Поместувањето на часовникот предизвикува одбиени барања што изгледаат случајно. - „Забранетиот ресурс“ (код 900908)
Ова обично значи дека вашиот клиентски ID не е претплатен на тоа API. Побарајте од поддршката за интеграција на ABDM да го овозможи, наместо да го менувате вашиот код. - Акредитиви со скриени простори
Копирањето тајна на клиентот од порталот може да додаде празно место на крајот или нов ред. Скратете го. - Третман на ABDM само како излезен
M2 и M3 зависат од тоа дали вашите крајни точки за повратен повик се достапни од портата. - Игнорирање на заштитата на податоците
ABHA тековите обработуваат Aadhaar броеви и здравствени картони. Дневници за согласност за план, енкрипција и престој на податоци во Индија според Закон за DPDP за апликации за здравствена заштита од самиот почеток.
Дизајнирањето на ABHA скрининг кај пациентите всушност завршува
API е само половина од работата. Пациентите ги напуштаат ABHA протоците кога се чувствуваат изгубени. Неколку навики помагаат:
- Прво прашајте дали пациентот веќе има ABHA и дали по дифолт е најавување, а не креирање.
- Кажете каде ќе оди OTP-кодот („на мобилниот поврзан со вашиот Aadhaar“) пред да го испратите
- Понудете малајаламски, хинди, тамилски и други јазици што ги користат вашите пациенти
- Објаснете ги барањата за согласност со едноставни зборови: кој сака кои записи, за колку долго
- Дозволете му на пациентот да продолжи со консултацијата ако ABHA не успее и обидете се повторно подоцна.
Како Сигософт гради апликации за телемедицина подготвени за ABHA
Сигософт гради апликации за телемедицина за клиники, болници и здравствени стартапи. Нашата апликација Медицино , на пример, комбинира закажување лекар, видео консултации и испорака на лекови во еден производ. За индиските клиенти, го планираме ABHA во првото издание, а не како подоцнежен додаток.
Во еден проект на ABHA, нашиот тим се справува со:
- Патувањето низ песочната кутија: апликација, поставување на клиент и планирање на пресвртници (M1 со M2 или M1 со M3)
- Тече М1: Креирање на ABHA, најавување, картичка, QR и скенирање и споделување, изградено на V3, изградено на V3.
- Слојот за повратен повик: сигурни крајни точки на мостот за M2 и M3, со дневник за ревизија за секоја согласност и пренос
- Безбедност и усогласеност: a тест за пенетрација пред безбедносната ревизија со персонализиран CERT-In, така што наодите ќе излезат на површина пред формалната ревизија, плус согласност и обработка на податоци според Законот за заштита на лични податоци преку нашиот Услуги за усогласеност со Законот за заштита на лични податоци (DPDP Act)
- Остатокот од производот: WebRTC видео повици, е-рецепти, плаќања и безбедна облачна архитектура
Доколку планирате нов производ, нашиот водич за градење на 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 или испратете ги вашите барања , а ние ќе ви одговориме со план за проектот.
Извори
- Број на АБХА, 95.99 крори од 31 јули 2026 година (одговор на Лок Сабха): Животот во Кашмир
- Бројки на ABDM од состанокот на Управната група на мисијата на 10 јули 2026 година: Индиски фармацевтски пост, Државникот
- ABHA лични карти по година, од 2021 до 2025 година: Вести за дигитално здравје, мај 2026 година
- Повици за запишување во V3, заглавија и RSA OAEP енкрипција: Форум за развивачи на ABDM, проток на адреси на ABHA; Форум за развивачи на ABDM, креирање на M1 за V3; Водич за референца за ABHA V3 API (средно)
- Крајни точки за најавување, картичка и сертификат V3: Конфигурација на PSMRI FHIR-API
- Sandbox хостови, продукциски хостови и чекори за сертификација: Нирмити, интеграција на ABDM чекор по чекор (2026)
- V3 синхроно откривање и URL за еден мост: Нирмити, водич за миграција V3
- Чести грешки (временски ознаки, акредитиви, 403): Нирмит, 25 вообичаени грешки; Форум за развивачи на ABDM, код 900908
- Две пресвртници пред излез од песочникот: Форум за развивачи на ABDM
- Безбедносна ревизија од агенција овластена од CERT-In: Астра, декември 2025 година
- Продолжување на DHIS до 30 јуни 2025 година: Парламентот на Шанкар ИАС
- Пресвртница за M4 и NHCX: Водич за пресвртници Nirmitee, ABDM M1 до M4
- Временски рамки за интеграција: IGNEK, ABDM пресвртници и сертификација
- Е-рецептите се вратени во евиденцијата поврзана со ABHA: Medical365, водич за телемедицина во Индија
Ви благодариме за повратните информации!
Започнете ја дискусијата
Прашања или искуства за споделување? Нашиот тим чита и одговара.





