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 sandbox: пацієнти, спостереження, результати лабораторних досліджень, стани, медикаменти, International Patient Summary, згода пацієнта та контекст ШІ, на TypeScript та Dart / Flutter.

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

Швидкий старт за 2 хвилини

1. Отримайте безкоштовний ключ для пісочниці: увійдіть на dashboard та натисніть Get a sandbox key (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, потім запустіть код у розділі Connect або клонуйте quickstart-ts.

Для кого це призначено

Розробники, які створюють додатки для здоров'я пацієнтів та їхніх родин, бекенди для медичних додатків, інтеграції для клінік та лабораторій, а також AI-асистенти чи агенти, яким потрібен структурований медичний контекст пацієнта — без необхідності самостійно проєктувати медичну базу даних, систему згоди та журнал аудиту.

Отримайте ключ для пісочниці

Пісочниця є безкоштовною та доступною для самостійного використання. Увійдіть за допомогою 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

Обидва охоплюють всю публічну поверхню (/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).

Приклади

Приклади працюють з безкоштовним пісочником (sandbox), де кожен проект пісочника має власні 30 синтетичних пацієнтів — див. Отримати ключ пісочника.

Пов'язані репозиторії

Відповідність

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

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

• Посібники для розробників
• Початок роботи
• Пісочниця FHIR
• API для охорони здоров'я
• Платформа API для охорони здоров'я
• Платформа FHIR
• Посібник з 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), відстеженням походження кожного запису та 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. Creates автоматично надсилають Idempotency-Key; 429/5xx повторюються з відступами; термін дії OAuth токенів поновлюється один раз, і виклик повторюється.

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