知識マップ: 日レセAPIの全体像をソースコードから把握する ── ORCAの公開ソースを読む(全137エンドポイント対応表付き)

記事「日レセAPIの全体像をソースコードから把握する ── ORCAの公開ソースを読む(全137エンドポイント対応表付き)」の主張を、概念と関係(エッジ)に分解した知識グラフの全体です。各関係には根拠・確認日・確度が付いています。

ORCA(日レセ)はLinux上で動くオープンソースのOLTPモニタMONTSUQIの上で、業務プログラムをCOBOLで実装している。日レセAPIのURLとCOBOLプログラムの対応はlddef/*.ldのLD定義ファイルにbindapi宣言として宣言的に書かれており、テキストのgrepだけで全エンドポイントを列挙できる。5.2系ソースでは137エンドポイントが実在し、公式のAPI仕様一覧に載るのは約50件にとどまるが、残りは未文書化であっても、record/*.dbのレコード定義からリクエスト・レスポンスの仕様を導出できる。使用許諾契約は文書化APIも含めてプログラム全体を無保証としているため、本番で使うAPIには版の固定と月次公開ソースのdiff監視をセットにすることが推奨される。

flowchart LR
    accTitle: 日レセAPIの全体像をソースコードから読む知識マップ
    accDescr: ORCAのlddefとbindapi宣言、record定義がAPIのディスパッチとXML構造をどう決めるか、そして未文書化APIの発見と月次ソースのdiff監視という運用にどうつながるかを示す図。
    orca_api["日レセAPI"]
    orca["ORCA(日医標準レセプトソフト/日レセ)"]
    montsuqi["MONTSUQI(モンツキ)"]
    cobol["COBOL"]
    lddef["LD定義ファイル(lddef/*.ld)"]
    bindapi_declaration["bindapi宣言"]
    bind_declaration["bind宣言"]
    record_db_definition["record/*.db(データ構造定義)"]
    undocumented_orca_api["未文書化API"]
    orca_official_api_list["公式サイトのAPI仕様一覧"]
    orca_source_license["ORCA使用許諾契約(無保証条項)"]
    orca_source_diff_monitoring["月次スナップショットのdiff監視"]
    orca_monthly_source_snapshot["月次ソース公開スナップショット"]
    undetected_api_change["検知されないAPI変更"]
    orca_api_ruby_library["orca-api(Rubyライブラリ)"]
    orca -->|"実装を担う"| orca_api
    orca -->|"利用する"| montsuqi
    orca -->|"利用する"| cobol
    montsuqi -->|"利用する"| lddef
    orca_api -->|"に保存される"| lddef
    lddef -->|"利用する"| bindapi_declaration
    lddef -->|"利用する"| bind_declaration
    bindapi_declaration -->|"利用する"| cobol
    bind_declaration -->|"利用する"| cobol
    bindapi_declaration -->|"利用する"| record_db_definition
    orca_api -->|"利用する"| record_db_definition
    undocumented_orca_api -->|"利用する"| lddef
    undocumented_orca_api -->|"で確認できる"| record_db_definition
    orca_official_api_list -->|"で確認できる"| lddef
    orca_source_license -.->|"前提とする"| orca_source_diff_monitoring
    orca_source_diff_monitoring -->|"前提とする"| orca_monthly_source_snapshot
    orca_source_diff_monitoring -->|"軽減する"| undetected_api_change
    undocumented_orca_api -.->|"原因になり得る"| undetected_api_change
    orca_source_diff_monitoring -->|"推奨される対応"| undocumented_orca_api
    orca_api_ruby_library -->|"利用する"| orca_api

概念間の関係(全20件)

図と同じ関係を文章でも列挙します。表示している文と機械可読な意味データ(RDFa)は同じ要素に載っています。確度が「確立した関係」のものは直接の関係として、「条件付きの関係」のものは成立条件つきの言明(rdf:Statement)として表現しています。

• ORCA(日医標準レセプトソフト/日レセ)は日レセAPIの実装を担います。ORCAの5.2系ソースは27個のLD定義に合計137個のエンドポイントをbindapiとして実装している / 確度: 確立した関係 / 確認日: 2026-08-01 出典
• ORCA(日医標準レセプトソフト/日レセ)はMONTSUQI(モンツキ)を利用します。日レセはLinux上で動作するオープンソースのOLTPモニタMONTSUQIの上で動く / 確度: 確立した関係 / 確認日: 2026-08-01 出典
• ORCA(日医標準レセプトソフト/日レセ)はCOBOLを利用します。ORCAの業務ロジックはCOBOLで実装されている(5.2系ソースで1,754本・約406万行) / 確度: 確立した関係 / 確認日: 2026-08-01 出典
• MONTSUQI(モンツキ)はLD定義ファイル(lddef/*.ld)を利用します。MONTSUQIは画面クライアントやAPIからの要求を、lddefのLD定義を参照して担当のCOBOLプログラムへ渡す / 確度: 確立した関係 / 確認日: 2026-08-01 出典
• 日レセAPIはLD定義ファイル(lddef/*.ld)に保存されます。日レセAPIのURLとサーバー側プログラムの対応は、lddef/*.ldのLD定義ファイルに宣言的に書かれている / 確度: 確立した関係 / 確認日: 2026-08-01 出典
• LD定義ファイル(lddef/*.ld)はbindapi宣言を利用します。LD定義ファイルの中でbindapi宣言がAPIの入口を1行ずつ宣言する / 確度: 確立した関係 / 確認日: 2026-08-01 出典
• LD定義ファイル(lddef/*.ld)はbind宣言を利用します。LD定義ファイルの中でbind宣言が対話画面の入口を1行ずつ宣言し、bindapiと同居する / 確度: 確立した関係 / 確認日: 2026-08-01 出典
• bindapi宣言はCOBOLを利用します。bindapi宣言の第3引数が、そのAPIを処理するCOBOLプログラム名を指定する / 確度: 確立した関係 / 確認日: 2026-08-01 出典
• bind宣言はCOBOLを利用します。bind宣言の第3引数も、その画面を処理するCOBOLプログラム名を指定する / 確度: 確立した関係 / 確認日: 2026-08-01 出典
• bindapi宣言はrecord/*.db(データ構造定義)を利用します。bindapiが束ねるモジュールが扱うXMLリクエスト・レスポンスの構造は、record/*.dbのレコード定義に宣言される / 確度: 確立した関係 / 確認日: 2026-08-01 出典
• 日レセAPIはrecord/*.db(データ構造定義)を利用します。日レセAPIのレスポンス・リクエストのXMLタグ名は、record/*.dbのレコード定義の項目名がそのまま使われる / 確度: 確立した関係 / 確認日: 2026-08-01 出典
• 未文書化APIはLD定義ファイル(lddef/*.ld)を利用します。未文書化APIを含め、全てのエンドポイントはlddefのbindapi宣言から機械的に列挙できる / 確度: 確立した関係 / 確認日: 2026-08-01 出典
• 未文書化APIはrecord/*.db(データ構造定義)で確認できます。未文書化APIでも、lddefで担当プログラムを特定しrecord定義を読めば、リクエスト・レスポンスの全項目を導出できる / 確度: 確立した関係 / 確認日: 2026-08-01 出典
• 公式サイトのAPI仕様一覧はLD定義ファイル(lddef/*.ld)で確認できます。公式サイトのAPI仕様一覧(約50件)に載っているエンドポイントの実在は、lddefのbindapi宣言(全137件)と突き合わせて確認できる / 確度: 確立した関係 / 確認日: 2026-08-01 出典
• ORCA使用許諾契約(無保証条項)は月次スナップショットのdiff監視を前提とします。使用許諾契約が文書化APIも含めて無保証を明言している以上、本番フローに組み込むAPIには版の固定と月次スナップショットのdiff監視をセットにすべきとされる。検証・社内利用に留まるAPIにまで一律に要求されるものではない / 確度: 条件付きの関係 / 確認日: 2026-08-01 出典
• 月次スナップショットのdiff監視は月次ソース公開スナップショットを前提とします。diff監視は、毎月1日に前月1日時点のソースが公開される月次スナップショットの存在を前提とする / 確度: 確立した関係 / 確認日: 2026-08-01 出典
• 月次スナップショットのdiff監視は検知されないAPI変更を軽減します。月次スナップショットのdiff監視は、公式ドキュメントに現れない変更を早期に検知し、検知されないままのAPI変更というリスクを軽減する / 確度: 確立した関係 / 確認日: 2026-08-01 出典
• 未文書化APIは検知されないAPI変更の原因になることがあります。未文書化APIの変更は公式ドキュメントの更新として現れないため、ソースを読まない限り気づけない / 確度: 条件付きの関係 / 確認日: 2026-08-01 出典
• 月次スナップショットのdiff監視は未文書化APIに対する本記事の推奨です。未文書化APIを本番で使う場合、月次スナップショットのdiff監視を運用にセットすることが推奨される / 確度: 確立した関係 / 確認日: 2026-08-01 出典
• orca-api(Rubyライブラリ)は日レセAPIを利用します。orca-apiライブラリはRubyから日レセAPIを呼び出すためのOSSで、実務で使われてきたエンドポイントのカタログとしても参考になる / 確度: 確立した関係 / 確認日: 2026-08-01 出典

主要概念の定義

日レセAPI

ORCAが外部システム向けに提供するAPI群。5.2系ソース(2026年7月スナップショット)ではlddefのbindapi宣言を数えると137エンドポイントが実在する。

ORCA(日医標準レセプトソフト/日レセ)

日本医師会が提供する「日医標準レセプトソフト」の略称。ソースコードが公開されているレセプトコンピューター。

MONTSUQI(モンツキ)

日レセが載っている、Linux上で動作するオープンソースのOLTP(オンライントランザクション処理)モニタ。画面クライアントやAPIからの要求を受け、担当のCOBOLプログラムに処理を渡す。

LD定義ファイル(lddef/*.ld)

どのURL(画面・API)をどのCOBOLプログラムが処理するかを宣言する、ORCAソース中のディスパッチ表。5.2系スナップショットでは40本あり、うち27本にbindapi定義を持つ。

bindapi宣言

LD定義の中でAPIの入口を1行ずつ宣言する行。エンドポイント名と担当COBOLプログラム名を対応づける。

bind宣言

LD定義の中で対話画面の入口を1行ずつ宣言する行。画面名と担当COBOLプログラム名を対応づける。

未文書化API

公式サイトのAPI仕様一覧ページに掲載されていないが、ソース上のlddefには実在するエンドポイント。ソースが公開されているため、自分でドキュメントを起こして仕様を導出できる。

公式サイトのAPI仕様一覧

ORCA Projectの公式サイトが公開しているAPI仕様の一覧ページ。約50件のエンドポイントが掲載されている。

ORCA使用許諾契約(無保証条項)

支障なく動作することや瑕疵の不存在などについて、文書化APIを含むプログラム全体を無保証とするORCAの使用許諾契約の条項。

月次スナップショットのdiff監視

月次で公開されるORCAソースの前月分との差分(lddef・record・利用APIの担当COBOL)を取り、変更を早期に検知する運用。

orca-api(Rubyライブラリ)

日レセAPIをRubyから呼び出すためのサードパーティ製OSSライブラリ。実務で使われてきたエンドポイントのカタログとしても参考になる。

機械可読データ

• JSON-LD / Turtle ── この記事の知識グラフ全体
• 概念一覧 / 語彙(述語)の定義

このページはサイトの知識グラフ(_data/knowledge/)から自動生成されています。誤りの指摘はお問い合わせからお願いします。