Try it free in the sandbox · first FHIR call in 5 minutesFree · 30 synthetic patients · no card

SDK

Клиенты Dart / Flutter (anpheros_sdk) и TypeScript (@anpheros/sdk): одинаковая структура, идемпотентные операции создания, повторные попытки, обновление токена и процесс получения согласия.

Официальные клиентские библиотеки для FHIR R4 healthcare API с бесплатной FHIR песочницей: пациенты, наблюдения, результаты лабораторных исследований, состояния, медикаменты, International Patient Summary, согласие пациента и контекст ИИ, на TypeScript и Dart / Flutter.

Anpheros — это интероперабельная инфраструктура медицинских данных для создания медицинских приложений, медицинского программного обеспечения и сервисов ИИ. Каждый пациент имеет одну запись HL7 FHIR R4, которую он контролирует; приложения, клиники, лаборатории и агенты ИИ читают и записывают ее через Anpheros Platform API — с согласия пациента (OAuth 2.1 / SMART on FHIR), с указанием источника при каждой записи и журналом доступа, который может просмотреть пациент. Этот репозиторий содержит официальные клиентские библиотеки и исполняемые примеры.

Быстрый старт за 2 минуты

1. Получите бесплатный ключ для песочницы: войдите на панель управления и нажмите Получить ключ для песочницы (sk_test_…). В вашей песочнице будет 30 синтетических пациентов.
2. Проверьте работоспособность:

bash curl -H "Authorization: Bearer $ANPHEROS_KEY" "https://platform.anpheros.com/fhir/R4/Patient?_count=3"

3. Установите SDK и прочитайте запись: npm install @anpheros/sdk или dart pub add anpheros_sdk, затем выполните код в разделе Подключение или клонируйте quickstart-ts.

Для кого это предназначено

Разработчики, создающие приложения для здоровья пациентов и их семей, серверные части медицинских приложений, интеграции с клиниками и лабораториями, а также ИИ-ассистенты или агенты, которым нужен структурированный медицинский контекст пациента — без необходимости с нуля разрабатывать медицинскую базу данных, систему согласия и журнал аудита.

Получить ключ для песочницы

Песочница бесплатна и предоставляется в режиме самообслуживания. Войдите через Google на панели управления и нажмите Получить ключ для песочницы: вы мгновенно получите проект песочницы и ключ. Каждый проект песочницы содержит 30 синтетических пациентов — шесть месяцев данных об условиях, лекарствах, аллергиях, результатах лабораторных исследований и жизненно важных показателях — которые вы можете свободно изменять и сбрасывать в любое время. Ключи песочницы (sk_test_…) никогда не получают доступ к реальным данным пациентов.

При переходе на продакшн, продакшн предназначен для проверенных организаций с соглашением об обработке данных, и стоимость продакшна начинается от 49 евро в месяц с первым месяцем бесплатно (цены).

Подключение

import { Anpheros, apiKey } from '@anpheros/sdk';

const anpheros = new Anpheros({ auth: apiKey(process.env.ANPHEROS_KEY!) });   // sk_test_… in the sandbox
const { data: patients } = await anpheros.patients.list();
const labs = await anpheros.observations.list(patients[0].id, { category: 'laboratory', limit: 10 });
const ctx = await anpheros.context.build({ patient: patients[0].id, task: 'weekly check-in', budget_tokens: 1500, format: 'text' });

import 'package:anpheros_sdk/anpheros_sdk.dart';

final anpheros = Anpheros(auth: AnpherosAuth.apiKey('sk_test_…'));
final patients = await anpheros.patients.list();
final labs = await anpheros.observations.list(patients.data.first.id, category: 'laboratory', limit: 10);

API-ключи должны храниться на серверах. Приложение, действующее от имени пользователя, вместо этого использует OAuth: оба SDK реализуют поток согласия (код авторизации + PKCE) и автоматически обновляют токены.

Что охватывают SDK

Оба SDK охватывают всю публичную поверхность (/v1, /fhir/R4, /oauth/token, /oauth/revoke) с той же структурой: patients, observations, conditions, medications, documents, timeline, provenance, context, grants, terminology и необработанные fhir. Тест завершается с ошибкой сборки, если публичный маршрут отсутствует в одном из SDK или если SDK вызывает маршрут, которого нет на сервере.

Оба SDK: автоматическое Idempotency-Key при создании, повторные попытки с экспоненциальной задержкой при 429/5xx, однократное обновление токена при 401, типизированные ошибки с идентификатором запроса, вспомогательные функции PKCE и поток согласия.

Медицинские данные и FHIR

Запись состоит из стандартных ресурсов FHIR R4 — 26 типов, включая Observation, Condition, MedicationStatement, DocumentReference, Immunization и AllergyIntolerance — с кодировкой LOINC, ICD-10, ATC и UCUM. REST API (/v1) и FHIR API (/fhir/R4) читают и записывают одни и те же ресурсы с одинаковыми идентификаторами; fhir в обоих SDK предоставляет прямой доступ к FHIR (поиск, транзакции, $everything, $summary, $validate).

Примеры

Примеры работают с бесплатной песочницей, где каждый проект песочницы имеет свои 30 синтетических пациентов — см. Получить ключ песочницы.

Связанные репозитории

Соответствие

Необработанные результаты тестов, опубликованные для проверки (результаты тестов, а не сертификация): conformance/. 28 сентября 2026 года группа Standalone Launch набора тестов Inferno SMART App Launch STU2 (v1.0.3) прошла 22 из 22 тестов на платформе. Запуск EHR не поддерживается.

Документация

• Руководства для разработчиков
• Начало работы
• FHIR sandbox
• Healthcare API
• Healthcare API platform
• FHIR platform
• Руководство по SDK
• Справочник по API (OpenAPI)
• Для ИИ-ассистентов
• Anpheros

Проблемы и безопасность

Сообщайте об ошибках в разделе issues данного репозитория. Никогда не включайте в сообщения об ошибках API-ключи, токены или данные пациентов. Для сообщений о проблемах безопасности обращайтесь по адресу: [email protected].

Лицензия

Apache License 2.0 — см. файл LICENSE каждого пакета. Copyright 2026 Anpheros.

@anpheros/sdk

Клиент на TypeScript для Anpheros Platform: карта здоровья пациента в формате FHIR R4, изоляция проектов, согласие пациента (OAuth 2.1 / SMART on FHIR), отслеживание происхождения каждой записи и API контекста ИИ. Работает везде, где fetch (Node 18+, браузеры, Deno, Bun).

import { Anpheros, apiKey } from '@anpheros/sdk';

const anpheros = new Anpheros({ auth: apiKey(process.env.ANPHEROS_KEY!) });
const { data: patients } = await anpheros.patients.list();
const labs = await anpheros.observations.list(patients[0].id, { category: 'laboratory', limit: 10 });
const ctx = await anpheros.context.build({ patient: patients[0].id, task: 'weekly check-in', budget_tokens: 1500, format: 'text' });

Действие от имени пользователя:

import { OAuthFlow, OAuthAuth, generatePkce } from '@anpheros/sdk';

const flow = new OAuthFlow({ baseUrl: BASE, clientId: 'client_…', redirectUri: 'https://myapp.example/callback' });
const pkce = await generatePkce();
location.href = flow.authorizeUrl({ scopes: ['patient/Observation.rs?category=laboratory', 'offline_access'], state, pkce, lang: 'ro' });
// on the callback:
const tokens = await flow.exchange(code, pkce);
const anpheros = new Anpheros({ auth: new OAuthAuth({ tokens, onRefresh: flow.refresh, onTokens: persist }) });

Ошибки AnpherosError (status, type, message, field, requestId). При создании отправляется Idempotency-Key; ошибки 429/5xx повторяются; истекшие токены обновляются один раз, и вызов повторяется.

anpheros_sdk

Dart / Flutter клиент для Anpheros Platform: бэкенд для медицинских данных с записью FHIR R4 на пациента, изоляцией проектов, согласием пациента (OAuth 2.1 / SMART on FHIR), отслеживанием происхождения (provenance) при каждой записи и API контекста ИИ.

import 'package:anpheros_sdk/anpheros_sdk.dart';

final anpheros = Anpheros(auth: AnpherosAuth.apiKey('sk_test_…'));      // server / sandbox

final patients = await anpheros.patients.list();
final elena = patients.data.first;
final labs = await anpheros.observations.list(elena.id, category: 'laboratory', limit: 10);
final ctx = await anpheros.context.build(ContextRequest(patient: elena.id, task: 'weekly check-in', budgetTokens: 1500));

Действия от имени пользователя (приложения)

final flow = OAuthFlow(baseUrl: 'https://…', clientId: 'client_…', redirectUri: 'myapp://callback');
final pkce = Pkce.generate();
final url = flow.authorizeUrl(scopes: ['patient/Observation.rs?category=laboratory', 'patient/MedicationStatement.r', 'offline_access'],
                              state: 'abc', pkce: pkce, lang: 'ro');
// open `url`; on return with ?code=…:
final tokens = await flow.exchange(code: code, pkce: pkce);
final anpheros = Anpheros(auth: AnpherosAuth.oauth(
  accessToken: tokens.accessToken, refreshToken: tokens.refreshToken, expiresAt: tokens.expiresAt,
  onRefresh: flow.refresh, onTokens: persist));
final meds = await anpheros.medications.listMedications(tokens.patient!);

Каждый объект несет fhir (ссылку на его /fhir/R4); anpheros.fhir предоставляет прямой доступ к FHIR (read, search, create, transaction, $everything, $summary, $validate).

Ошибки AnpherosException с status, type, message, field и requestId. Операции create автоматически отправляют Idempotency-Key; ошибки 429/5xx повторяются с экспоненциальной задержкой; истекшие токены OAuth обновляются один раз, и вызов повторяется.

Try it free in the sandbox · first FHIR call in 5 minutesFree · 30 synthetic patients · no card