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

医療データAPI

Anpheros APIの各医療データ種別の格納場所、コーディング方法、書き込み、フィルタリング、追跡、修正、削除の方法を、動作する例と共に説明します。

医療データAPIは、患者記録の内容に構造化されたアクセスをソフトウェアに提供します。患者の作成、血圧測定値の記録、現在処方されている薬剤のリスト表示、検査レポートの添付、誰が何を書いたかの追跡などを行います。このページでは、Anpheros API のデータ操作について説明します。各医療データがどこに格納され、どのようにコーディングされ、どのように読み戻せるかについて、サンドボックスで動作する例とともに解説します。

アプリケーションは、これらの操作を使用して Anpheros を製品の医療データベースとして扱います。患者記録はプラットフォームの HL7 FHIR R4 ストアに保存され、アプリケーションは独自の医療データテーブルを保持する代わりに、API を介して読み書きします。

より広範な情報（認証、同意、イベント）については、ヘルスケアAPI を参照してください。

各種医療データの格納場所

医療データ	REST v1	FHIRリソース	コーディング
患者情報	`POST /v1/patients`	`Patient`	name, birth date, gender, identifiers
バイタルサイン、検査結果、症状、活動、アンケート	`/v1/patients/{id}/observations`	`Observation`	LOINC (症状: ICD-10 chapter R); UCUM units
診断と問題	`/v1/patients/{id}/conditions`	`Condition`	ICD-10
薬剤	`/v1/patients/{id}/medications`	`MedicationStatement`	ATC, product name kept as text
書類 (PDF, 画像)	`/v1/patients/{id}/documents`	`DocumentReference`	LOINC document kinds
検査レポート全体	`POST /v1/patients/{id}/labs/import`	`Observation` (laboratory)	LOINC where known, the lab's own code otherwise
服用またはスキップされた用量、予防接種、アレルギー、処置、レポート、ケアプラン、目標、紹介、受診、予約、ケアチーム、家族歴、質問票	`/fhir/R4/{type}`	`MedicationAdministration`, `Immunization`, `AllergyIntolerance`, `Procedure`, `DiagnosticReport`, `CarePlan`, `Goal`, `ServiceRequest`, `Encounter`, `Appointment`, `CareTeam`, `FamilyMemberHistory`, `QuestionnaireResponse`	per FHIR code systems

REST v1 オブジェクトと FHIR リソースは、同じ ID を持つ同じレコードです。すべての v1 オブジェクトは fhir 参照を保持しています。

医療データの書き込み

# a lab result with its reference range, linked to the report it came from
curl -X POST https://platform.anpheros.com/v1/patients/$PID/observations \
     -H "Authorization: Bearer $KEY" -H 'content-type: application/json' -H "Idempotency-Key: $(uuidgen)" -d '{
  "code": "4548-4", "display": "Hemoglobin A1c", "category": "laboratory",
  "value": 6.4, "unit": "%", "effective_at": "2026-09-01T08:00:00Z",
  "reference_range": {"low": 4.0, "high": 5.6},
  "derived_from": ["DocumentReference/'$DOC'"], "author_type": "import"
}'

観測カテゴリ: vital-signs, laboratory, symptom, activity, survey, exam, imaging, social-history。
複合測定値（例：血圧）は、components（収縮期 8480-6、拡張期 8462-4 をパネル 85354-9 内で使用します。
作成者タイプ: patient, practitioner, device, import, ai。指定しない場合、プラットフォームは import を記録します。
暗記していないコード: GET /v1/terminology/loinc?q=hba1c はバンドルされた LOINC サブセットを検索し、GET /v1/search?q=metformin は症状、病状、薬剤のカタログを検索します。表示名なしで記述された観測値は、自動的に LOINC 名が割り当てられます。

医療データの読み取り

curl "https://platform.anpheros.com/v1/patients/$PID/observations?category=laboratory&code=4548-4&from=2026-01-01" -H "Authorization: Bearer $KEY"
curl "https://platform.anpheros.com/v1/patients/$PID/conditions?clinical_status=active" -H "Authorization: Bearer $KEY"
curl "https://platform.anpheros.com/v1/patients/$PID/medications?status=active" -H "Authorization: Bearer $KEY"
curl "https://platform.anpheros.com/v1/patients/$PID/timeline?from=2026-06-01" -H "Authorization: Bearer $KEY"

エンドポイント	フィルター
observations	`category`, `code`, `from`, `to`
conditions	`clinical_status`
medications	`status`
documents	`kind`
timeline	`from`, `to`, `types`

リストは limit および cursor でページングされます。timeline は、観察結果、病状、投薬、文書、受診、予約、予防接種、ケアエピソードを 1 つの時系列リストにマージします。これは、患者履歴画面の自然な入力となります。

REST フィルターでカバーされないものについては、FHIR 検索を使用してください: GET /fhir/R4/Observation?patient=$PID&code=http://loinc.org|4548-4&_sort=-date (FHIR プラットフォーム)。

トレーシングとデータの修正

作成者: GET /v1/patients/{id}/provenance/{type}/{resourceId} — バージョンごとに1つのエントリ。作成者のタイプ、プロジェクト、組織、ソースシステムが含まれます。
すべてのバージョン: GET /fhir/R4/{type}/{id}/_history; 誰かの変更を上書きしないように、If-Match で更新してください。
所有権: 同意を得れば、他の組織が作成したものを読み取ることができますが、自分のプロジェクトが作成したもののみを変更または削除できます（それ以外の場合は403）。
削除: DELETE /v1/{observations|conditions|medications}/{id}; Patient を削除すると、レコード全体が削除されます。

ドキュメント

ドキュメントを作成し（アップロード先を取得）、プラットフォーム経由または直接ストレージにバイトをアップロードしてから、最終化します。最終化後、元のドキュメントは変更不可能となり、そのSHA-256ハッシュとサイズが記録されます。ファイルあたり最大25 MiBです。