# Створення з Anpheros

> Шлях від доступу до продакшену за дев'ять кроків — автентифікація, API, медичні дані, згода, FHIR, вебхуки, SDK та запуск — з посібником для кожного кроку.

Source: https://developers.anpheros.com/uk/guides/build-with-anpheros

**Створення на базі Anpheros означає використання його як шару медичних даних вашого застосунку: ваш продукт викликає Anpheros API для зберігання та читання записів пацієнтів у форматі HL7 FHIR R4, отримання згоди пацієнта та отримання подій.** Ця сторінка є картою від першого доступу до продакшену; кожен крок посилається на посібник, який детально його розглядає.

## 1. Отримайте доступ

Платформа Anpheros перебуває в приватній бета-версії. Пісочниця є самообслуговуваною: увійдіть за допомогою Google на панелі керування (`https://platform.anpheros.com/dashboard/`) і натисніть *Отримати ключ пісочниці* — ви отримаєте організацію, проект пісочниці з власними 30 синтетичними пацієнтами та ключ. Доступ до виробничого середовища здійснюється за запитом (`contact@anpheros.com`). Ви створюєте додаткові проекти та ключі API на панелі керування або через Admin API; OAuth-додатки реєструються за допомогою `POST /admin/projects/{id}/applications`, а вебхуки — за допомогою `POST /v1/webhooks`.

**Проект** є одиницею ізоляції: його ключі бачать лише створених ним пацієнтів (і, за згодою, тих, хто надав йому доступ).

## 2. Автентифікація

| Облікові дані | Для | Виглядає як |
|---|---|---|
| API ключ | ваші сервери | `sk_test_…` (sandbox), `sk_live_…` (production) |
| OAuth токен доступу | додаток, що діє від імені одного пацієнта | `at_…`, дійсний 30 хвилин, оновлюється за допомогою ротаційного токена оновлення |

Надішліть його як `Authorization: Bearer <credential>`. Ключі відображаються один раз і ніколи не повинні бути в мобільному або веб-додатку. → [Автентифікація та OAuth](https://developers.anpheros.com/uk/guides/authentication)

## 3. Підключення до API

Базовий URL `https://platform.anpheros.com`; REST за адресою `/v1`, FHIR R4 за адресою `/fhir/R4`. Інтерактивне довідкове керівництво та специфікація OpenAPI описують кожен кінцевий пункт.

```bash
curl https://platform.anpheros.com/v1/patients -H "Authorization: Bearer $KEY"
```

→ [Довідник API](https://developers.anpheros.com/docs) · [Healthcare API](https://developers.anpheros.com/uk/guides/healthcare-api)

## 4. Створення та читання медичних даних

Створіть пацієнта для кожного з ваших користувачів, записуйте спостереження, стани, медикаменти та документи за допомогою `Idempotency-Key`, а потім читайте їх як списки або хронологію. Вказуйте автора кожного запису (`patient`, `practitioner`, `device`, `import`, `ai`).

→ [Початок роботи](https://developers.anpheros.com/uk/guides/getting-started) · [API медичних даних](https://developers.anpheros.com/uk/guides/medical-data-api) · [Створення медичного додатку](https://developers.anpheros.com/uk/guides/build-a-healthcare-app)

## 5. Надання згоди

Щоб отримати доступ до запису, який людина вже зберігає в Anpheros, зареєструйте OAuth-додаток із його URI перенаправлення, надішліть людину на сторінку згоди з потрібними вам областями доступу (scopes) та обміняйте код (PKCE) на токени. Людина обирає тривалість і може відкликати доступ у будь-який час; кожне читання їй видиме.

→ [Модель згоди та доступу](https://developers.anpheros.com/uk/guides/consent) · [Автентифікація та OAuth](https://developers.anpheros.com/uk/guides/authentication)

## 6. Використовуйте FHIR, коли вам потрібна повна модель

Типи ресурсів, що виходять за межі REST API — імунізації, процедури, плани догляду, алергії, зустрічі та інші, всього 26 — доступні через FHIR R4, разом із пошуком, історією, транзакціями, `$everything` та Міжнародним резюме пацієнта (`$summary`).

→ [Платформа FHIR](https://developers.anpheros.com/uk/guides/fhir) · [Системи кодування FHIR](https://developers.anpheros.com/uk/guides/fhir-code-systems) · [Інтероперабельність медичних даних](https://developers.anpheros.com/uk/guides/interoperability)

## 7. Реагування на події

Зареєструйте кінцеву точку вебхука для подій `resource.*`, `consent.*` або `document.finalized` та перевіряйте `Anpheros-Signature` кожної доставки. Лабораторні звіти можуть надсилатися одним викликом до лабораторного конектора.

→ [Вебхуки](https://developers.anpheros.com/uk/guides/webhooks) · [Лабораторний конектор](https://developers.anpheros.com/uk/guides/lab-connector) · [Медичні інтеграції](https://developers.anpheros.com/uk/guides/healthcare-integrations)

## 8. Використання SDK

`@anpheros/sdk` (TypeScript: Node 18+, браузери, Deno, Bun) та `anpheros_sdk` (Dart / Flutter) охоплюють весь публічний API з однаковою структурою, додають ключі ідемпотентності до операцій створення, повторюють запити при `429`/`5xx`, оновлюють токени та реалізують потік згоди.

```bash
npm install @anpheros/sdk        # or: dart pub add anpheros_sdk
```

→ [SDK](https://developers.anpheros.com/uk/guides/sdks)

## 9. Перехід на продакшн

- Ключі продакшну (`sk_live_`) видаються верифікованим організаціям з підписаною угодою про обробку даних.
- Врахуйте обмеження приватного бета-тестування: одна зона, відсутність договірних SLA, 600 запитів на хвилину на ключ та на IP.
- Обробляйте помилки за типом та зберігайте `Anpheros-Request-Id` для підтримки.
- Перегляньте, як захищені дані та де вони зберігаються.

→ [Безпека, конфіденційність та місцезнаходження даних](https://developers.anpheros.com/uk/guides/security) · [Обмеження](https://developers.anpheros.com/uk/guides/limits) · [Помилки](https://developers.anpheros.com/uk/guides/errors) · [Версіонування та виведення з експлуатації](https://developers.anpheros.com/uk/guides/versioning)

## Додавання ШІ

Якщо ваш продукт включає ШІ-асистента або агента, контекстний API готує відповідну частину запису для моделі, яку ви використовуєте, в межах бюджету токенів і з кожним елементом, позначеним за джерелом. → [Медичні ШІ-додатки](https://developers.anpheros.com/uk/guides/ai-healthcare)

## Пов'язане

- [Anpheros для розробників](https://developers.anpheros.com/uk/guides/developers)
- [Розробка програмного забезпечення для охорони здоров'я](https://developers.anpheros.com/uk/guides/healthcare-software)
- [Стартапи в галузі охорони здоров'я](https://developers.anpheros.com/uk/guides/healthcare-startups)