トランスフェリン飽和度の計算

TIBC が零では除数に使えず、負の鉄や結合能は物理的に意味がないため、それらの場合は invalid_input となり課金されません。

トランスフェリン飽和度が測るものと必要な入力

両方の測定が同じ濃度単位なら単位は打ち消されるため、マイクログラム毎デシリットルのパネルとマイクロモル毎リットルのパネルは、一つのリクエストで二つの体系を混ぜない限り同じ百分率になります。本エンドポイントは性別ごとの基準範囲を適用せず、マイクログラム毎デシリットルとマイクロモル毎リットルの換算もせず、フェリチン・可溶性トランスフェリン受容体・ヘプシジンも推定しません。必須の有限フィールド serum_iron と tibc を送ってください。iron、fe、serum_fe、total_iron_binding_capacity、tibc_ugdl、iron_binding_capacity などのエイリアスは文書化されている場合に受け付けます。実用的な範囲は教室と一般の入力を健全に保ち、両フィールドとも使う一致単位で零から二千までです。飽和度は除算のため TIBC は厳密に零より大きくなければならず、結合能が零だと invalid_input になります。経路はネットワークもモデルも乱数シードも壁時計もない純粋な算術なので、同一入力は常に同一 JSON を返します。

飽和度・応答フィールドとエラーの読み方

血清鉄が TIBC より大きいと飽和度は百パーセントを超え得ます。静脈内鉄のあとや一部の測定アーチファクトで起こり得ます。計算機は打ち切らず算術結果を報告するので、上限表示が欲しいクライアントは独自の方針を適用できます。フェリチン解釈器、貧血分類器、鉄検査の完全な判断エンジン、マイクログラム毎デシリットルをマイクロモル毎リットルに写す単位換算器と混同しないでください。検索意図も契約も別です。本製品は一致した二つの濃度を割り、百を掛けるだけです。成功時の応答は serum_iron と tibc を安定した丸めで返し、比較に使う全精度の百分率を saturation_percent として報告し、画面表示用に小数第二位までの saturation_rounded も付けます。unit_saturation は常に percent です。formula は教育用の式を一つの文字列で述べ、method は常に transferrin_saturation_iron_over_tibc なので、下流コードは形を嗅がずに分岐できます。テストで安定した数値比較が必要なときは saturation_percent を、検査カードやチャートの横に数字を出すときは saturation_rounded を使ってください。必須フィールド欠落、空文字列、非有限値、範囲外の読取、負の血清鉄または TIBC、TIBC が零の場合はすべて invalid_input となり課金されません。必須の二つの数を含む JSON 本体を POST してください。各フィールドは JSON 数でも数値文字列でも構いません。真偽値、オブジェクト、NaN、Infinity は、失敗したコントロールをフォームが強調できるようフィールド名を含むメッセージで拒否されます。

API利用・価格・製品ワークフローと実用上の限界

同じ濃度単位の必須値 serum_iron と tibc を含む JSON 本体を送ってください。健康教育アプリ、電子ワークシート、シミュレーションラボ、チュータリング基盤、学校の LMS が KIT 残高の下で安定した契約を必要とする場合は前払い API を使い、成功項目ごとに $0.002 です。自施設の検査単位と臨床フローと組み合わせ、血清鉄と TIBC が同じ単位で報告されたことを確認し、SI と慣用が混ざったパネルを転記した場合は一方を換算したうえで、生の入力と並べて saturation_percent と saturation_rounded をダッシュボードやエクスポート列に保存してください。SDK を出荷する作者は、式文字列を教材カードに示し、ご自身で定義する教育しきい値の色チップに saturation_rounded を写せます。