本文へスキップ

開発者向け — Mirai Move API と SDK

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

この API が提供するもの

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

対象

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

認証モデル

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

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

セキュリティ境界

  • Authentication is a bearer credential issued under governed human approval; there is no self-service key issuance.
  • Credentials are never embedded in any artifact; every published artifact is secret-scanned as built bytes.
  • All access is read-only; write, outreach and payment functions are not part of the API contract.
  • Every request, including refusals, is audited server-side with durable rate limiting.
  • The package consumes the governed Mirai Move read API only: released deliverables, Cases, evidence, matches, solution gaps and monitoring, within the credential's scopes and classification ceiling.
  • No customer data leaves the customer's systems through the SDK beyond the API requests it makes; the SDK stores nothing.
  • No internal infrastructure, provider integration or internal source code is part of any customer package.

アクセスを申請する

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

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