# Создание с Anpheros

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

Source: https://developers.anpheros.com/ru/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 key | ваши серверы | `sk_test_…` (песочница), `sk_live_…` (продакшн) |
| OAuth access token | приложение, действующее от имени одного пациента | `at_…`, действует 30 минут, обновляется с помощью ротируемого refresh token |

Отправляйте его как `Authorization: Bearer <credential>`. Ключи показываются один раз и никогда не должны находиться в мобильном или веб-приложении. → [Аутентификация и OAuth](https://developers.anpheros.com/ru/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/ru/guides/healthcare-api)

## 4. Создание и чтение медицинских данных

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

→ [Начало работы](https://developers.anpheros.com/ru/guides/getting-started) · [API медицинских данных](https://developers.anpheros.com/ru/guides/medical-data-api) · [Создание медицинского приложения](https://developers.anpheros.com/ru/guides/build-a-healthcare-app)

## 5. Добавление согласия

Чтобы получить доступ к записи, которую человек уже ведет в Anpheros, зарегистрируйте OAuth-приложение с его URI перенаправления, отправьте человека на страницу согласия с необходимыми вам областями действия (scopes) и обменяйте код (PKCE) на токены. Человек выбирает срок действия и может отозвать доступ в любое время; каждое чтение будет ему видно.

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

## 6. Используйте FHIR, когда вам нужна полная модель

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

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

## 7. Реагирование на события

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

→ [Webhooks](https://developers.anpheros.com/ru/guides/webhooks) · [Lab connector](https://developers.anpheros.com/ru/guides/lab-connector) · [Healthcare integrations](https://developers.anpheros.com/ru/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/ru/guides/sdks)

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

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

→ [Безопасность, конфиденциальность и местоположение данных](https://developers.anpheros.com/ru/guides/security) · [Ограничения](https://developers.anpheros.com/ru/guides/limits) · [Ошибки](https://developers.anpheros.com/ru/guides/errors) · [Версионирование и прекращение поддержки](https://developers.anpheros.com/ru/guides/versioning)

## Добавление ИИ

Если ваш продукт включает ИИ-ассистента или агента, контекстный API подготавливает соответствующую часть записи для используемой вами модели, в пределах лимита токенов и с маркировкой каждого элемента по источнику. → [Приложения ИИ в здравоохранении](https://developers.anpheros.com/ru/guides/ai-healthcare)

## Связанные материалы

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