Для интеграции ABHA в приложение телемедицины необходимо зарегистрироваться в песочнице ABDM, получить токен доступа к шлюзу и получить открытый ключ ABDM. Затем нужно создать или проверить ABHA пациента через API регистрации и входа в систему V3, предварительно зашифровав номер Aadhaar и одноразовый пароль (OTP) с помощью RSA-шифрования. Это соответствует этапу M1 разработки ABDM. Для обмена и получения записей о консультациях необходимо добавить этапы M2 и M3, а затем пройти функциональные тесты NHA и аудит безопасности, прежде чем получить ключи для производственной среды.
Вот почему это важно на практике. Пациент в Кожикоде подключается к видеоконсультации, и врач запрашивает результаты анализа HbA1c за прошлый год. Без ABHA пациент будет просматривать фотографии в WhatsApp, пока идёт отсчёт времени. С подключенной системой ABHA пациент подтверждает запрос на своём телефоне, и результаты отображаются на экране врача. Именно этот небольшой момент вы и создаёте.
Приведенные ниже вызовы API соответствуют API версии V3 от ABDM, которые заменили более старые потоки V1 и V2.
Быстрый ответ
- Что такое ABHA: 14-значный идентификатор здоровья в рамках цифровой миссии «Аюшман Бхарат» (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.
Многие из них получили его в государственной больнице или лагере. Просить их повторно вводить свои данные кажется слишком долгим процессом, когда достаточно сканирования QR-кода или одноразового пароля. - Пациенты больницы просят об этом.
Больницы и клиники, работающие с государственными программами, все чаще ожидают от своих пациентов программного обеспечения, готового к применению методов ABDM (Account-Based Design — разработка, ориентированная на решение конкретных задач). - Врачи получают более полную информацию.
Предыдущие рецепты и отчеты поступают к врачу с его согласия, поэтому консультация проходит быстрее и безопаснее.
В этом руководстве рассматриваются обе стороны работы с ABHA: бизнес-аспект ABDM (этапы, согласие, сертификация и защита данных) и запросы на обновление до версии V3, которые делают ваши разработчики.
Этапы интеграции ABHA: M1, M2 и M3
| Вехи | Что делает ваше приложение для телемедицины? | роль ABDM |
|---|---|---|
| M1 | Создайте учетную запись ABHA, подтвердите учетную запись ABHA, предъявите карту ABHA и QR-код, примите условие «Сканировать и поделиться» при регистрации. | Услуги ABHA |
| M2 | Привязывайте каждую консультацию к контексту оказания медицинской помощи и обменивайтесь записями только с согласия пациента. | Поставщик медицинской информации (HIP) |
| M3 | Запросите медицинские карты пациента у других врачей и покажите их врачу. | Пользователь медицинской информации (HIU) |

В руководствах по интеграции также описывается четвертый этап, M4, для обработки цифровых страховых претензий через Национальную биржу медицинских страховых претензий (NHCX). Большинству телемедицинских приложений это не требуется на этапе запуска, но стоит предусмотреть это, если ваши клиенты — больницы, которые подают страховые претензии ( Nirmitee ).
Начните с этапа M1 и сначала проверьте его работу с реальными пациентами. Обратите внимание, что NHA сообщила пользователям песочницы на своем форуме разработчиков , что перед демонстрацией выхода из песочницы необходимо пройти как минимум два этапа, поэтому планируйте этапы M1 и M2 одновременно.
Интеграция API ABHA: вызовы V3, шаг за шагом.
В тестовой среде базовыми хостами являются abhasbx.abdm.gov.in/abha/api для вызовов ABHA и dev.abdm.gov.in для шлюза. В производственной среде используются другие хосты и новые учетные данные, которые NHA выдает после выхода из тестовой среды.
Шаг 1: Получите доступ к песочнице.
Подайте заявку в песочницу ABDM, указав данные вашей организации и сценарий использования (например, приложение для телеконсультаций). После одобрения вы получите идентификатор клиента и секретный ключ клиента. С самого начала храните секретный ключ в менеджере секретов, а не в коде.
Шаг 2: Получите токен доступа к шлюзу.
Для получения токена доступа используйте API сессий шлюза, указав свой идентификатор клиента и секретный ключ. Каждый последующий вызов отправляет следующие заголовки:
| заголовок | Значение |
|---|---|
| Авторизация | Токен Bearer из 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:
import crypto from 'node:crypto';
// publicKeyPem: ключ из /v3/profile/public/certificate, упакованный в формате PEM.
export function encryptForAbdm(value, publicKeyPem) {
return crypto.publicEncrypt(
{ key: publicKeyPem, padding: crypto.constants.RSA_PKCS1_OAEP_PADDING, oaepHash: 'sha1' },
Buffer.from(value, 'utf8')
).toString('base64');
}
Шаг 5: Запросите OTP-код Aadhaar.
POST /v3/enrollment/request/otp
{
“txnId”: “”,
«объем»: [«абха-энрол»],
«loginHint»: «аадхаар»,
“loginId”: “ ”,
“otpSystem”: “aadhaar”
}
В ответ возвращается идентификатор транзакции (txnId) и сообщение о том, что одноразовый пароль (OTP) был отправлен на номер мобильного телефона, привязанный к Aadhaar пациента. Сохраните txnId для следующего звонка.
Шаг 6: Подтвердите одноразовый пароль (OTP) и создайте ABHA.
POST /v3/enrollment/enrol/byAadhaar
{
“authData”: {
“authMethods”: [“otp”],
“otp”: {
“txnId”: “ ”,
“otpValue”: “ ”,
«мобильный»: « ”
}
},
“consent”: { “code”: “abha-enrollment”, “version”: “1.4” }
}
Если указанный пациентом номер мобильного телефона отличается от номера, привязанного к его Aadhaar, ABDM запросит подтверждение с помощью второго OTP. Повторно вызовите /v3/enrollment/request/otp с областью действия mobile-verify и параметром 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). Для клиник, которые также принимают пациентов без предварительной записи, поддержите функцию Scan & Share, при которой пациент сканирует QR-код вашего учреждения, и его данные попадают на экран регистрации. Министерство сообщает, что на данный момент сгенерировано почти 24 миллионов токенов Scan & Register, поэтому пациенты к этому уже привыкли.
Шаг 9: Связать консультации и получить записи (M2 и M3)
После того, как M1 заработает, каждая телеконсультация становится контекстом оказания медицинской помощи, связанным с личным кабинетом пациента (ABHA). Когда другой врач запрашивает согласие пациента, ваше приложение отправляет записи в виде зашифрованного пакета FHIR. Для M3 ваш врач отправляет запрос на согласие, пациент одобряет его в своем приложении PHR, и записи поступают в ваше приложение.
Одно изменение в версии V3 затрагивает многие команды: шлюз отправляет обратный вызов на ваш сервер. В версии V3 поиск пациентов осуществляется синхронно , и все обратные вызовы поступают на один URL-адрес моста, при этом заголовок X-HIP-ID указывает, к какому учреждению относится запрос. Вашему бэкэнду нужны общедоступные и надежные конечные точки для обратных вызовов, а не просто исходящие вызовы API.
Как работает процесс получения согласия
В системах M2 и M3 записи никогда не проходят через центральное хранилище. Пациент сам решает, кто что видит, в каждом конкретном случае:
- Ваш врач, выступая в качестве пользователя медицинской информации (HIU), направляет запрос на получение согласия через шлюз ABDM.
- Пациент подтверждает это в своем приложении для управления медицинской информацией и выбирает, какие типы записей и в какой временной интервал следует предоставить.
- Шлюз уведомляет поставщика медицинских услуг, хранящего записи, — поставщика медицинской информации (HIP).
- HIP отправляет зашифрованный пакет FHIR в ваше приложение, которое расшифровывает его и отображает врачу.
Из этого вытекают два правила. Отправляйте только контекст оказания медицинской помощи и временной интервал, одобренный пациентом, никогда не отправляйте полную историю болезни. И ведите журнал аудита каждого запроса согласия, одобрения и передачи данных, поскольку проверка безопасности и любые запросы о защите данных будут его проверять.
После телеконсультации перенесите электронный рецепт обратно в связанные с ABHA медицинские записи пациента в качестве нового контекста лечения, чтобы пациент мог увидеть его в своем приложении PHR и поделиться им со следующим врачом ( Medical365 ).

От песочницы ABDM к производству
- Сначала соберите и протестируйте M1, затем M2 или M3 в песочнице.
- Пройти функциональные тесты NHA для каждого этапа.
- Получите аудит безопасности веб-приложений (WASA) от компании... CERT-In — аккредитованное агентствоВ компаниях, занимающихся вопросами безопасности, такой результат также называют сертификатом Safe-to-Host.
- Продемонстрируйте программное обеспечение NHA и отправьте форму для выхода из песочницы.
- Получите учетные данные для работы в производственной среде и переключитесь на рабочие хосты.
- Зарегистрируйте каждое учреждение в Реестре медицинских учреждений. Сертификация распространяется на программное обеспечение, а не на каждую клинику, которая его использует.

NHA обновляет этот процесс, поэтому перед планированием дат уточните текущие шаги на сайте песочницы ABDM .
Распространенные ошибки при интеграции ABHA
- Копирование старых учебных пособий
Во многих сообщениях блога, включая нашу более раннюю версию этой статьи, указаны пути V1 или V2. Сборка выполняется только на основе V3. - Отправка обычных значений Aadhaar или OTP.
V3 ожидает значения, зашифрованные с помощью RSA. Использование обычных значений недопустимо. - Неверные временные метки
Отправляйте UTC в формате ISO 8601 и синхронизируйте серверные часы с NTP. Расхождение во времени приводит к отклонению запросов, которые выглядят случайными. - «Ресурс запрещен» (код 900908)
Обычно это означает, что ваш идентификатор клиента не подписан на этот API. Обратитесь в службу поддержки интеграции ABDM, чтобы они включили его, вместо того чтобы менять свой код. - Учетные данные со скрытыми пробелами
При копировании секретного ключа клиента с портала может появиться пробел или перевод строки в конце. Удалите его. - Рассмотрение ABDM исключительно как исходящих звонков.
M2 и M3 зависят от доступности ваших точек обратного вызова со стороны шлюза. - Игнорирование защиты данных
В рамках системы ABHA обрабатываются номера Aadhaar и медицинские записи. Планируются журналы согласия, шифрование и определение места жительства индийских данных. Закон DPDP для медицинских приложений от начала.
Разработка экранов ABHA позволяет пациентам действительно завершить обучение.
API — это только половина дела. Пациенты отказываются от использования ABHA-систем, когда чувствуют себя растерянными. Несколько полезных привычек помогают:
- Сначала спросите, есть ли у пациента уже регистрация в ABHA, и по умолчанию запрашивайте данные для входа, а не для создания учетной записи.
- Перед отправкой укажите, куда будет отправлен одноразовый пароль (OTP) («на мобильный телефон, привязанный к вашему Aadhaar»).
- Предлагайте своим пациентам говорить на малаяламском, хинди, тамильском и других языках.
- Объясните запросы на согласие простыми словами: кто хочет получить какие записи и на какой срок.
- Если ABHA не поможет, пусть пациент продолжит консультацию и попробует снова позже.
Как Sigosoft разрабатывает приложения для телемедицины, готовые к сертификации ABHA
Компания Sigosoft разрабатывает приложения для телемедицины для клиник, больниц и стартапов в сфере здравоохранения. Например, наше приложение Medicino объединяет запись к врачу, видеоконсультации и доставку лекарств в одном продукте. Для индийских клиентов мы планируем включить ABHA в первый релиз, а не в качестве последующего дополнения.
В рамках проекта ABHA наша команда занимается следующим:
- Путешествие в песочнице: Разработка приложения, настройка клиента и планирование этапов (M1 с M2 или M1 с M3)
- Потоки М1: Создание ABHA, вход в систему, карта, QR-код и сканирование с возможностью обмена, разработано на основе V3.
- Слой обратного вызова: Надежные точки подключения для M2 и M3 с журналом аудита для каждого согласия и передачи.
- Безопасность и соответствие: a тестирование на проникновение перед проверкой безопасности, проводимой аккредитованным CERT-InТаким образом, результаты выявляются до проведения официальной проверки, а также в соответствии с Законом о защите персональных данных и конфиденциальности (DPDP Act) и правилами обработки данных, установленными нашей компанией. услуги по обеспечению соответствия Закону о защите персональных данных
- Остальная часть продукта: видеозвонки WebRTCэлектронные рецепты, платежи и безопасная облачная архитектура
Если вы планируете новый продукт, наше руководство по созданию MVP для телемедицины без его последующей переработки объяснит, как с самого начала предусмотреть место для ABDM (Account-Based Design — анализ, принятие решений и адаптация).
FAQ
Что такое интеграция ABHA?
Это позволяет вашему приложению создавать или проверять номер ABHA пациента и связывать с ним его медицинские записи. В терминах ABDM это этап M1.
Что такое песочница ABDM?
Это тестовая среда, где вы создаете и тестируете функции ABHA, M2 и M3, прежде чем NHA выдаст учетные данные для работы в производственной среде. Каждая организация, независимо от ее размера, начинает именно с этого.
Какую версию API ABHA мне следует использовать в 2026 году?
Используйте API версии V3. Более старые версии V1 и V2 устарели, а для версии V3 требуются номера Aadhaar и одноразовые пароли (OTP), зашифрованные с помощью RSA.
Обязательна ли интеграция с ABHA для приложений телемедицины?
Не существует общего правила, согласно которому каждое приложение для телемедицины должно интегрировать ABHA. На практике больницы и государственные программы все чаще ожидают от программного обеспечения готовности к ABDM, поэтому это влияет на то, каких пациентов вы можете обслуживать.
Сколько времени занимает интеграция ABHA?
Разработку M1 можно выполнить за несколько недель, если ваша команда хорошо знакома с тестовой средой. Полный путь к внедрению в производство также зависит от функционального тестирования NHA, аудита безопасности и демонстрации, поэтому планируйте на месяцы, а не на недели. Интеграторы публикуют оценки сроков от 8 до 12 недель с опытным партнером до 5-10 месяцев для разработки с нуля.ИГНЕКРассматривайте это как заявления поставщика, а не как эталонные показатели.
Мне также нужны M2 и M3?
M1 охватывает саму ABHA. Для обмена записями консультаций необходим M2, а для получения записей от других поставщиков — M3. NHA запросила как минимум два этапа перед выходом из песочницы.
Нужен ли мне сертифицированный партнер для интеграции ABHA?
Нет, любая зарегистрированная организация может подать заявку на доступ к тестовой среде. Партнер, имеющий опыт работы в тестовой среде, в основном экономит ваше время на деталях версии V3, обратных звонках и подготовке к аудиту.
Планируете интеграцию ABHA?
Расскажите нам о вашем приложении, необходимых этапах и дате запуска. Отправьте электронное письмо по адресу [email protected] , позвоните по телефону +91 98462 37384 или пришлите ваши требования , и мы ответим вам планом проекта.
Источники
- Подсчет ABHA, 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
- Тестовые и производственные хосты, а также этапы сертификации: Нирмити, пошаговая интеграция ABDM (2026)
- Синхронное обнаружение V3 и единый URL-адрес моста: Руководство по миграции Nirmitee, V3
- Распространенные ошибки (временные метки, учетные данные, ошибка 403): Нирмити, 25 распространенных ошибок; Форум разработчиков ABDM, код 900908
- Два важных этапа перед выходом из песочницы: Форум разработчиков ABDM
- Аудит безопасности, проводимый агентством, аккредитованным CERT-In: Астра, декабрь 2025 г.
- Продление DHIS до 30 июня 2025 г.: Шанкар, член Индийской административной службы, Парламент
- M4 отмечает достижение важной вехи, а NHCX: Нирмити, руководство по этапам ABDM от M1 до M4
- Сроки интеграции: Этапы сертификации IGNEK и ABDM
- Электронные рецепты перенесены в записи, связанные с ABHA: Medical365, руководство по телемедицине в Индии
Спасибо за ответ!
Начать обсуждение
Есть вопросы или хотите поделиться опытом? Наша команда читает ваши сообщения и отвечает на них.





