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

バージョン管理と非推奨

FHIR R4およびREST v1インターフェース、Webhookペイロード、SDKがどのように変更されるか、また破壊的変更がどのように通知されるかについて。

• /fhir/R4 の FHIR R4 および /v1 の REST v1 は安定したインターフェースです。追加的な変更（新しいフィールド、新しいリソースタイプ、新しいエンドポイント、新しいイベントタイプ）は通知なしでリリースされます。SDK および docs/openapi.json は同じコミットで再生成され、そうでない場合はテストが失敗します。
• 破壊的変更には新しいプレフィックス（/v2）が付けられ、少なくとも 6ヶ月間 並行稼働します。古いプレフィックスはこの期間中、Deprecation および Sunset ヘッダーで応答します。
• Webhook ペイロードは type を持ちます。新しいタイプは追加的なものです。* を購読しているユーザーは、不明なタイプを無視する必要があります。
• SDK は semver に従います。メジャーな SDK バージョンでは、廃止された API プレフィックスが削除される場合があります。
• セキュリティ修正は、バージョンアップなしで検証（例：バリューセット）を厳格化する場合があります。このような厳格化は、アクティブな脆弱性をクローズしない限り、30日間の通知をもって変更履歴に記載されます。

Changelog

2026年10月14日 (追加: 同意画面のブランディング、チームのシングルサインオン)

• チームのシングルサインオン: 組織をSAMLまたはOIDCプロバイダーおよびそのメールドメイン (PUT /admin/organizations/{id}/sso、プラットフォーム管理者) にリンクでき、メンバーにシングルサインオンを必須にできます。GET /admin/sso/discover?email= (認証なし) は、職場メールのプロバイダーを返します。OrganizationOut は sso_provider_id、sso_domains、sso_required を取得します。チームのシングルサインオン を参照してください。

• PUT /admin/applications/{id}/branding は、アプリケーションのロゴ (PNG/JPEG/WebP データ URI、最大64 KB) およびアクセントカラー (白文字とのコントラストが4.5:1以上) を設定します。これはホストされた同意画面に表示されます。ApplicationOut は logo および brand_color を取得します。認証とOAuth を参照してください。

• 価格ページおよび価格: プライベートベータに関する注記。本番環境は、検証と署名済みDPAの後に開始され、プランはメールで請求され、割り当てはまだ自動的に強制されません。

2026年10月14日 (エラー形式と検査結果のマッピング修正)

• 検査結果のインポート: Uree / Urea は、BUN / Urea nitrogen (mmol/L単位の14937-7) に保持される尿素窒素 (3094-0) ではなく、尿素 (3091-6; mmol/L単位の22664-7) にマッピングされます。値は変換されません。古いマッピングを使用していた本番データはありません。
• 検査結果のインポート: レポートにメソッドがあるLDLは、計算LDL (13457-7) または直接LDL (18262-6) にマッピングされます。メソッドがない場合は 2089-1 のままです。Direct は現在修飾子であるため、Bilirubina directa はもはや総ビリルビン (1975-2) にマッピングされません。検査結果のコードが保持されます。古いマッピングを使用していた本番データはありません。
• /v1 の下にある不明なエンドポイントとメソッドは、{"detail": "Not Found"} の代わりに、文書化されたエラー形式 (404 not-found、405 not-supported) で応答します。無効なクエリパラメータと /v1 の下のIPあたりのレート制限は、/fhir/R4 の下で (変更なし) OperationOutcome の代わりに {"error": …} を使用します。/v1 の下の予期しない 500 は error.type = "exception" を運びます (以前は error.code を運んでいました)。
• 検査結果のインポート: ローカルまたは非LOINCコーディングシステムを持つHL7 v2の結果は、urn:anpheros:lab-code (以前はurn:hl7:<system>、例: urn:hl7:l) の下で検査結果のコードを保持します。既に保存されている結果は変更されません。
• 検査結果のインポート: 英語のLOINC名と同義語が認識されます (Hemoglobin A1c, Glycated hemoglobin, HDL cholesterol, LDL cholesterol, Haemoglobin)。単独の Glucose は、Glicemie のように血清または血漿 (2345-7) にマッピングされます。修飾子を持つ名前で、コンセプトが欠落しているもの (urine, non-HDL…) は、関連するテストにマッチしなくなりました。この変更前は、LOINCコードなしで送信された HDL cholesterol および LDL cholesterol は総コレステロール (2093-3) として保存されていました。
• 検査結果のインポート: レポートの再送信は、LOINCマッピングが変更された場合に結果を重複しなくなりました。新しい結果は、レポート (レポートID、レポート上の名前とコード、日付、値、単位) から構築された2番目の識別子、urn:anpheros:lab-import:v2 を運びます。既存の識別子は変更されず、以前の結果は名前、日付、値、単位、レポートIDによって認識されます。レポート上で名前が異なるがLOINCコード、日付、値が同じ2つの結果 (Glucose と Glicemie の例) は、もはや1つにマージされません。

2026年10月13日 (追加、契約変更なし)

• 同意は、1つの共有ルールで、すべての派生ビュー (/v1/context、/v1/patients/{id}/timeline、ポータル、$everything) で強制されます。要求されたがカバーされていないセクションは、コンテキストのomitted に表示されます。
• OpenAPIは、操作ごとのsecurity およびすべての操作のレスポンススキーマに加えて、servers、securitySchemes (bearer、apiKey、oauth2、firebase) を宣言するようになりました。生成されたクライアントは型指定されたレスポンスを取得します。
• すべての401 は WWW-Authenticate: Bearer を運びます。
• CapabilityStatement は、SMART (oauth-uris 拡張、SMART-on-FHIR サービス) および IPS 実装ガイドを広告します。
• プロキシの背後にあるリダイレクトは https:// を保持します。
• python-multipart 0.0.20 → 0.0.32; pip-audit は既知の脆弱性でビルドをブロックします。
• Webhook URL は公開 HTTPS である必要があります。ローカルホスト (以前はサンドボックスで受け入れられていましたが、配信されませんでした)、プライベートおよび予約済みアドレス、およびそれらに解決する名前は、url で 400 を返して登録時に拒否されます。配信は、チェックしたばかりのIPアドレスにのみ接続します (DNSリバインディング)。

適合性強制 (2026年9月23日発表)

IPS / HL7 Europe の検査要件を満たさない書き込みは、現在 201/200 を Anpheros-Conformance ヘッダーと共に返します。観察期間 (予定: この通知から60〜90日) の後、プラットフォームはブロックモードに切り替わります。そのような書き込みは、すべてのギャップをリストした OperationOutcome を持つ 422 で応答します。より多くの時間が必要なインテグレーターは、移行期間中にプロジェクトごとに免除を受けることができます。2026年9月23日にリソースタイプが追加されました: Procedure, DiagnosticReport, CarePlan, FamilyMemberHistory, ServiceRequest, Goal (追加)。

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