API

HTTP APIリファレンス

IngaDBのHTTP APIでは、/db/v1以下で型付きグラフや証拠の登録・取得、決定論的な分析の実行、リビジョンや変更履歴の確認、What-if分析ができます。リクエストとレスポンスにはJSONを使用します。

OpenAPI 3.1API v1JSON

ベースURL

エンドポイントHTTPS

https://api.your-domain.com/db/v1

ローカルインスタンスの既定ベースURLはhttp://localhost:9876/db/v1です。

認証

外部からアクセスできる環境ではBearer認証を使用します。組織キーはcok_、個人トークンはcut_で始まります。ローカル開発用の設定では、組織IDをX-Org-Idヘッダーで指定することもできます。

リクエストヘッダー本番

Authorization: Bearer cok_…
Content-Type: application/json

リクエストヘッダーローカル開発

X-Org-Id: 8f78…
Content-Type: application/json

エンドポイント

グラフ

GET/db/v1

サービス情報と有効な機能を取得

GET/db/v1/graphs

呼び出し元の組織に属するグラフ一覧を取得

POST/db/v1/graphs

グラフを作成

GET/db/v1/graphs/{graphId}

一つのグラフを取得

DELETE/db/v1/graphs/{graphId}

グラフとそのデータを削除

トポロジー

GET/db/v1/graphs/{graphId}/topology

型付きトポロジーを取得

PUT/db/v1/graphs/{graphId}/topology

トポロジーをアトミックに置換

POST/db/v1/graphs/{graphId}/nodes

イベントまたはゲートを追加

PATCH/db/v1/graphs/{graphId}/nodes/{nodeId}

ノードを更新

POST/db/v1/graphs/{graphId}/edges

親から子へのエッジを追加

証拠とビュー

GET/db/v1/graphs/{graphId}/evidence

証拠レコード一覧を取得

POST/db/v1/graphs/{graphId}/evidence

証拠を追加

POST/db/v1/graphs/{graphId}/views/analysis

分析を計算、またはキャッシュ済みの結果を取得

GET/db/v1/graphs/{graphId}/views/analysis

分析結果と最新性を取得

POST/db/v1/graphs/{graphId}/views/what-if

保存せずにWhat-if分析を実行

POST/db/v1/graphs/{graphId}/compile

メカニズム事実からツリーを生成

来歴

GET/db/v1/graphs/{graphId}/revision

現在の入力リビジョンを取得

GET/db/v1/graphs/{graphId}/deltas

指定したリビジョン範囲の変更を取得

GET/db/v1/graphs/{graphId}/snapshots

計算済みビューの履歴を取得

GET/db/v1/chains

メカニズムの伝播経路をたどる

グラフを作成

リクエスト

POST/db/v1/graphs

{
  "name": "packaging-line",
  "description": "Causal model for line availability"
}

レスポンス · 200

application/json200

{
  "id": "gr_7f31c2",
  "name": "packaging-line",
  "stage": "active",
  "created_at": "2026-08-14T04:00:00Z"
}

分析結果の有効性を確認する

保存済みの分析結果が現在のグラフと同じリビジョンで計算されている場合、analysisに結果が入ります。リビジョンが異なる場合はanalysisがnullになり、計算時点と現在のリビジョン、その間に発生した変更が返ります。

GET/graphs/{graphId}/views/analysis

{
  "project_id": "gr_7f31c2",
  "analysis": null,
  "stale": true,
  "computed_at_revision": 41,
  "current_revision": 42,
  "changes_since": [
    {"kind":"node_edit","revision":42,"changed":[{"id":"E_SEAL","field":"probability"}]}
  ]
}

エラー

ステータス	意味	対応
`400`	入力エラー	必須フィールド、ノード種別、グラフ構造を確認します。
`401`	未認証	有効なBearer資格情報を指定します。
`403`	権限不足	対象の操作を実行できるロールを使用します。
`404`	対象が見つからない	指定したIDが、認証に使用した組織に属するか確認します。

エラーのレスポンス本文は常に{"error":"message"}の形式です。

バージョン管理

/db/v1では、既存のフィールドや動作との互換性を保ちながら、新しいフィールドや機能を追加します。クライアントは、認識できないレスポンスフィールドを無視してください。インスタンスで利用できる機能パックはGET /db/v1で確認できます。

次へTypeScriptまたはPythonクライアントを使う →