# Anpheros로 빌드하기

> 인증, API, 의료 데이터, 동의, FHIR, 웹훅, SDK 및 라이브 출시까지 9단계의 액세스부터 프로덕션까지의 경로 — 각 단계별 가이드 포함.

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

**Anpheros 기반으로 빌드한다는 것은 애플리케이션의 의료 데이터 레이어로 Anpheros를 사용하는 것을 의미합니다. 즉, 귀사의 제품은 Anpheros API를 호출하여 HL7 FHIR R4 형식으로 환자 기록을 저장하고 읽으며, 환자 동의를 얻고 이벤트를 수신합니다.** 이 페이지는 최초 액세스부터 프로덕션까지의 로드맵이며, 각 단계는 상세 내용을 다루는 가이드로 연결됩니다.

## 1. 액세스 권한 얻기

Anpheros Platform은 비공개 베타 버전입니다. 샌드박스는 셀프 서비스로 이용 가능합니다. 대시보드(`https://platform.anpheros.com/dashboard/`)에서 Google로 로그인하고 *샌드박스 키 받기*를 누르면 조직, 30명의 합성 환자가 포함된 샌드박스 프로젝트, 그리고 키를 얻게 됩니다. 프로덕션 액세스는 요청(`contact@anpheros.com`)을 통해 가능합니다. 추가 프로젝트 및 API 키는 대시보드 또는 Admin API를 통해 생성할 수 있습니다. OAuth 애플리케이션은 `POST /admin/projects/{id}/applications`에, 웹훅은 `POST /v1/webhooks`에 등록합니다.

**프로젝트**는 격리의 단위입니다. 프로젝트의 키는 해당 프로젝트에서 생성한 환자만 볼 수 있습니다 (동의 시 액세스를 허용한 환자도 포함).

## 2. 인증

| 자격 증명 | 대상 | 형식 |
|---|---|---|
| API 키 | 귀하의 서버 | `sk_test_…` (샌드박스), `sk_live_…` (프로덕션) |
| OAuth 액세스 토큰 | 한 명의 환자를 대신하여 작동하는 앱 | `at_…`, 30분 유효, 순환 갱신 토큰으로 갱신됨 |

`Authorization: Bearer <credential>`으로 전송하십시오. 키는 한 번만 표시되며 모바일 또는 웹 앱에 절대 포함되어서는 안 됩니다. → [인증 및 OAuth](https://developers.anpheros.com/ko/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/ko/guides/healthcare-api)

## 4. 의료 데이터 생성 및 읽기

사용자별로 환자를 생성하고, `Idempotency-Key`를 사용하여 관찰 기록, 상태, 약물 및 문서를 작성한 후, 목록 또는 타임라인으로 다시 읽어옵니다. 모든 작성의 작성자(`patient`, `practitioner`, `device`, `import`, `ai`)를 명시합니다.

→ [시작하기](https://developers.anpheros.com/ko/guides/getting-started) · [의료 데이터 API](https://developers.anpheros.com/ko/guides/medical-data-api) · [헬스케어 앱 빌드](https://developers.anpheros.com/guides/build-a-healthcare-app)

## 5. 동의 추가

Anpheros에 이미 저장된 기록에 접근하려면, 리디렉션 URI와 함께 OAuth 애플리케이션을 등록하고, 필요한 스코프를 포함하여 해당 사용자를 동의 페이지로 보낸 후, 코드를 토큰으로 교환합니다(PKCE). 사용자는 기간을 선택할 수 있으며 언제든지 접근 권한을 철회할 수 있습니다. 모든 읽기 작업은 사용자에게 표시됩니다.

→ [동의 및 접근 모델](https://developers.anpheros.com/ko/guides/consent) · [인증 및 OAuth](https://developers.anpheros.com/ko/guides/authentication)

## 6. 전체 모델이 필요한 경우 FHIR 사용

REST API 외의 리소스 유형 — 예방접종, 시술, 진료 계획, 알레르기, 내원 등 총 26가지 — 은 FHIR R4를 통해 검색, 기록, 트랜잭션, `$everything` 및 국제 환자 요약(`$summary`)과 함께 사용할 수 있습니다.

→ [FHIR 플랫폼](https://developers.anpheros.com/ko/guides/fhir) · [FHIR 코드 시스템](https://developers.anpheros.com/ko/guides/fhir-code-systems) · [의료 데이터 상호 운용성](https://developers.anpheros.com/ko/guides/interoperability)

## 7. 이벤트에 응답하기

`resource.*`, `consent.*` 또는 `document.finalized` 이벤트에 대한 웹훅 엔드포인트를 등록하고 모든 전송의 `Anpheros-Signature`를 확인합니다. 검사 보고서는 검사 커넥터에 대한 단일 호출로 전송될 수 있습니다.

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

## 9. 운영 환경으로 전환하기

- 운영 키(`sk_live_`)는 데이터 처리 계약에 서명한 검증된 조직에 발급됩니다.
- 비공개 베타의 제한 사항을 고려하십시오: 단일 존, 계약된 SLA 없음, 키당 및 IP당 분당 600개 요청.
- 오류 유형별로 처리하고 지원을 위해 `Anpheros-Request-Id`을 보관하십시오.
- 데이터 보호 방식과 저장 위치를 검토하십시오.

→ [보안, 개인 정보 보호 및 데이터 상주](https://developers.anpheros.com/ko/guides/security) · [제한 사항](https://developers.anpheros.com/ko/guides/limits) · [오류](https://developers.anpheros.com/ko/guides/errors) · [버전 관리 및 사용 중단](https://developers.anpheros.com/ko/guides/versioning)

## AI 추가

제품에 AI 어시스턴트 또는 에이전트가 포함된 경우, 컨텍스트 API는 토큰 예산 내에서 각 항목의 출처를 레이블링하여 모델에 레코드의 관련 부분을 준비합니다. → [AI 의료 애플리케이션](https://developers.anpheros.com/ko/guides/ai-healthcare)

## 관련 자료

- [개발자를 위한 Anpheros](https://developers.anpheros.com/ko/guides/developers)
- [헬스케어 소프트웨어 개발](https://developers.anpheros.com/ko/guides/healthcare-software)
- [헬스케어 스타트업](https://developers.anpheros.com/ko/guides/healthcare-startups)