本文へスキップ

開発者向け — Mirai Move API と SDK

リリース済み成果物・Case・根拠・マッチ・ソリューションギャップ・モニタリングを、権限の範囲内で読み取る、統制された読み取り専用 API です。書き込み・外部連絡・決済の機能は契約に存在しません。

この API が提供するもの

組織のワークスペースに属するリリース済み意思決定文書(正確な版指定つき)、閲覧権限のある Case、その根拠パッセージ、マッチ評価、ソリューションギャップ、そして全体の鮮度・健全性モニタリング。すべて読み取り専用です。

対象

エンタープライズ・大学・研究機関の統合開発者、および組み込みインテリジェンス顧客。

アクセス・プロファイル

同じ API 基盤を、用途別の上限プロファイルとして提供します。プロファイル自体はアクセスを付与せず、実際の資格情報は組織・権限・スコープを個別に承認して発行します。

Research Access

大学 · 研究機関

cases:read · evidence:read · suppliers:read · matches:read · monitoring:read

PUBLIC

Enterprise Intelligence API

事業会社 · OEM · モビリティ事業者

cases:read · suppliers:read · matches:read · solution-gaps:read · monitoring:read

PERMISSIONED

Partner Integration API

実装パートナー · 技術パートナー

cases:read · matches:read · solution-gaps:read · monitoring:read

PERMISSIONED

認証モデル

Bearer 資格情報。人による統制された承認の下でのみ発行され、公開のセルフサービス発行はありません。資格情報は組織単位で、ハッシュのみ保存され、有効期限と失効があります。

スコープ

資格情報は明示的なスコープ列を持ちます:

cases:read · evidence:read · suppliers:read · matches:read · solution-gaps:read · monitoring:read · deliverables:read

レート制御

資格情報ごとに毎分の上限(既定 60 リクエスト/分)が永続的に強制されます。超過は HTTP 429 と Retry-After で拒否され、拒否も監査されます。

データ区分

すべての応答エンベロープは classification_ceiling(PUBLIC / PERMISSIONED)と record_class(REAL / SYNTHETIC_ACCEPTANCE)を明示します。合成データは常に合成と表示されます。

サンプル/合成環境

record_class = SYNTHETIC_ACCEPTANCE の資格情報では、応答はすべて合成データであり、その旨がエンベロープに明示されます。実データと混在することはありません。

エラー/拒否

拒否は型付きです:UNAUTHENTICATED・FORBIDDEN_SCOPE・RATE_LIMITED・NOT_FOUND・STORE_FAILED。SDK は各拒否を型付き例外として送出します。

ページング

一覧は limit と cursor によるカーソル方式です。SDK には全ページ走査ヘルパーがあります。

契約と版

契約は v1。契約の変更は新しい版として提供され、SDK には対象契約の SHA-256 ダイジェストが埋め込まれます。

openapi sha256: 7b5f61d69207bcaba6e32fd680fc73761b7ed63cf0338e3819bebbe8afbef4d6

API リファレンス

公式 SDK(自己ホスト配布)

外部レジストリ登録を待たず、Mirai Move 自身から決定的なアーティファクトを配布します。各アーティファクトには版・契約版・契約ダイジェスト・チェックサム・ライセンス・README・例・変更履歴が含まれ、資格情報は一切埋め込まれていません。

ソフトウェア/エージェント・パッケージ

統合パッケージ(MM-SWP)の内容・データ境界・セキュリティモデルは、パッケージ・マニフェストが正典です。合成サンプル文書で構成を確認できます。

パッケージ納品文書のサンプルを見る

セキュリティ境界

  • 認証は Bearer 資格情報です。発行は統制された人の承認を経る場合に限られ、セルフサービスでの発行はありません。
  • 資格情報がアーティファクトに埋め込まれることはありません。公開されるアーティファクトは、ビルドされたバイト列そのものに対して秘密情報の検査を行っています。
  • アクセスはすべて読み取り専用です。書き込み・外部への連絡・決済の機能は、API 契約に存在しません。
  • 拒否された場合を含め、すべてのリクエストがサーバー側で記録され、利用量の上限が継続的に強制されます。
  • このパッケージが利用するのは、統制された Mirai Move の読み取り API のみです。対象は、公開済みの成果物・Case・根拠・適合性評価・ソリューションギャップ・モニタリングで、いずれも資格情報に許可された範囲と公開区分の内側に限られます。
  • SDK を通じて顧客のデータが顧客のシステムの外に出ることは、API リクエストそのものを除いてありません。SDK は何も保存しません。
  • 社内の基盤、外部サービスとの接続、社内のソースコードは、顧客に渡すパッケージには一切含まれません。

アクセスを申請する

資格情報の発行は統制された人の承認を経ます。公開ページでの発行はありません。

ワークスペース / API を依頼する