リファレンス
仕様ファイル
機械で読める仕様を、次のファイルで配信しています。ツールの連携や、AIが参照するときに使います。
ファイル
- OpenAPI 3.1 JSON:134操作の、入力・応答・認証の定義。
- 全API一覧 JSON:公開する134操作の一覧と、それぞれの提供状態。
- 現在のMCPツール定義 JSON:取込アダプターの8ツール。
- このガイドのMarkdown:AIやテキストのツールが参照するための形式。
- 実行例のJSON:HTTP・実行例の元のデータ。
OpenAPIの接続先と認証のURLは、接続できない説明用の値です。利用環境に合わせた版の作り方は、利用者として接続するの「OpenAPIのツールから使う」を参照してください。
文書改訂15の元OpenAPIは、2026-10-07の固定commit 74b35558b25da7c8d7bbb0be18f74b79e8765316です。元仕様のSHA-256は29e0a6fcd763b3efb855ef40dd3018f06cae790a64db3b2e37c26273d333a63bです。文書対象の出典情報に、対象版とMCP配布物の固定値を記載しています。稼働版は接続先ごとに確認してください。
ファイルの整合を確認する
manifestに、公開しているファイルのSHA-256を記載しています。取得したファイルは、manifestのfilesの値と照合できます。
files["v0.7/openapi.json"]は、公開用に題名や説明を整えた、配信ファイルそのもののSHA-256です。ダウンロードしたOpenAPIは、この値と照合します。source_openapi_sha256は、公開用に整える前の、元のOpenAPIの値です。配信ファイルとは、一致しません。- manifest自身は、自己参照を避けるため、
filesに含みません。 - MCPクライアントのZIPのSHA-256は、manifestには含みません。MCPの導入に載せています。
照合のコマンドは、WindowsはGet-FileHash -Algorithm SHA256、macOSはshasum -a 256、Linuxはsha256sumです。
アプリからこのドキュメントへリンクする
アプリからリンクするときは、利用しているAPIの版に対応した、/v0.7/のURLを使います。アプリ向けのリンク定義に、安定したリンク先を記載しています。