Anpheros ヘルスケアバックエンド

Anpheros ヘルスケアバックエンド は何をしますか？

Anpheros は各個人の健康記録を標準的な HL7 FHIR R4 リソースとして保存し、同じデータをシンプルな REST API（/v1）と厳格な FHIR（/fhir/R4）の両方で公開します。ID は両方で同一です。

• ベース URL: https://platform.anpheros.com（キーによってサンドボックスか本番環境かが決まります）
• ガイド: https://developers.anpheros.com/guides/ — OpenAPI: /docs — CapabilityStatement: /fhir/R4/metadata
• ドキュメント MCP サーバー（アカウント不要、読み取り専用）: https://platform.anpheros.com/mcp/docs
• SDK: npm install @anpheros/sdk（TypeScript）、anpheros_sdk（Dart/Flutter）

ルール（常に守ること）

1. サンドボックスを優先する。 sk_test_ キーを使用します。このキーはプロジェクトの合成患者データのみにアクセスします。本番環境の患者データをサンドボックスに絶対に入れず、sk_live_ キーをコード、例、コミットに書き込まないでください。キーは環境変数（ANPHEROS_KEY）から読み取ります。
2. コードを独自に作成しない。 LOINC、SNOMED CT、ICD-10、ICD-11、ATC、RxNorm コードは、公式コードシステムまたは用語検索（GET /v1/search?q=…、GET /v1/search/{id}）から取得します。コードが不明な場合は省略します。単位は UCUM（mg/dL、mmHg、kg）です。
3. 同意は必須。 API キーは、自身のプロジェクトが作成した患者のみを参照できます。既存の記録にアクセスするには、同意フロー（下記ステップ 4）を通じて患者に依頼します。403 は「同意の範囲外」を意味します。さらに同意を求め、回避しないでください。失効後の 401 はアクセス終了を意味します。
4. 誰が書き込んだかを明記する。 すべての書き込み操作には author_type（patient、practitioner、device、import、ai）を含めます。モデルによって書き込まれたデータは author_type: "ai" を使用します（HL7 AI 透明性ラベルはプラットフォームによって追加されます）。
5. 診断や治療アドバイスは行わない。 アプリは記録、傾向、パターンを表示できますが、ユーザーに疾患名や服用すべき薬を伝えてはいけません。
6. 再試行される可能性のある書き込み操作には Idempotency-Key ヘッダーを送信します。

ワークフロー

1. キーの取得。 開発者は https://platform.anpheros.com/dashboard/ にサインインし、サンドボックスキーを取得 を押します。
2. 読み取り。

   curl $BASE/v1/patients -H "Authorization: Bearer $ANPHEROS_KEY"
   curl "$BASE/v1/patients/$PID/observations?category=laboratory&limit=10" -H "Authorization: Bearer $ANPHEROS_KEY"
   curl "$BASE/v1/patients/$PID/timeline?from=2026-06-01" -H "Authorization: Bearer $ANPHEROS_KEY"
   

3. 書き込み。

   curl -X POST "$BASE/v1/patients/$PID/observations" -H "Authorization: Bearer $ANPHEROS_KEY" \
        -H 'content-type: application/json' -H "Idempotency-Key: $(uuidgen)" -d '{
     "code": "2339-0", "display": "Glucose", "category": "laboratory",
     "value": 112, "unit": "mg/dL", "effective_at": "2026-09-19T08:10:00Z", "author_type": "device"}'
   

   SDK を使用する場合:

   import { Anpheros, apiKey } from '@anpheros/sdk';
   const anpheros = new Anpheros({ auth: apiKey(process.env.ANPHEROS_KEY!) });
   const patient = await anpheros.patients.create({ given: 'Ana', family: 'Example', birth_date: '1980-05-17', gender: 'female' });
   

4. 同意（SMART on FHIR、OAuth 2.1 + PKCE）。 アプリケーションを登録し（POST /admin/projects/{id}/applications）、ユーザーを GET /oauth/authorize?…&scope=patient/Observation.rs offline_access&purpose=treatment にリダイレクトし、POST /oauth/token でコードを交換してから、Authorization: Bearer at_… で API を呼び出します。 ディスカバリー: /.well-known/smart-configuration。ガイド: https://developers.anpheros.com/guides/healthcare-api-patient-consent
5. AI コンテキスト。 POST /v1/context は、プロンプトに適合するレコードの部分を来歴付きで返します。これにより、生のリソースをモデルにダンプする代わりにコンテキストを提供できます。
6. 検査結果のインポート。 HL7 v2 ORU および CSV 形式の検査レポート: https://developers.anpheros.com/guides/import-lab-results-fhir

ここでカバーされていないトピックについてコードを書く前に、ガイド（ドキュメント MCP サーバーの search_docs、またはガイドインデックス）を検索してエンドポイントを推測しないようにしてください。