業務データ

業務データとオントロジー。値ごとの状態と出典を持つ

説明は公開 API の契約（OpenAPI）から生成しています。

エンドポイント

GET	/v1/data/types
GET	/v1/data/records
POST	/v1/data/records
GET	/v1/data/records/{id}
PATCH	/v1/data/records/{id}
GET	/v1/data/records/{id}/values/{field}/history
POST	/v1/data/records/{id}/values/{field}/confirm
GET	/v1/data/records/{id}/relations
POST	/v1/data/relations
POST	/v1/data/relations/{id}/state
GET	/v1/data/imports
POST	/v1/data/imports
GET	/v1/data/migrations
POST	/v1/data/migrations/backfill
GET	/v1/data/findings
GET	/v1/data/findings/{id}
POST	/v1/data/findings/{id}/close
GET	/v1/data/aspects
POST	/v1/data/knowledge/search
POST	/v1/data/ontology/query
GET	/v1/data/ontology/types/{type}/actions
POST	/v1/data/ontology/resolve

listTypes

GET/v1/data/types

有効なバージョンの型・項目・関係・計算の規則

応答

• 200 — object: 型
• default — Problem: RFC 9457 Problem Details

listRecords

GET/v1/data/records

パラメーター

名前	場所	型	必須	説明
type	query	string	はい
where	query	string		CEL。変数は record と states（例: record.status == “active”）
state	query	ValueState		この状態の値を持つものに絞る
field	query	string		state で見る項目
limit	query	integer
cursor	query	string
include	query	relations		relations なら、各レコードに今の関係を含める

応答

• 200 — object: レコード
• default — Problem: RFC 9457 Problem Details

createRecord

POST/v1/data/records

パラメーター

名前	場所	型	必須	説明
Idempotency-Key	header	string		副作用を伴う POST ではサーバーが必須にする。SDK は無ければ自動で付けるので、型では省略できる

リクエストの本文

application/json

名前	型	必須	説明
type	string	はい
values	object	はい

応答

• 201 — Record: レコード
• default — Problem: RFC 9457 Problem Details

getRecord

GET/v1/data/records/{id}

パラメーター

名前	場所	型	必須	説明
id	path	string	はい

応答

• 200 — object: レコードと関係と履歴
• default — Problem: RFC 9457 Problem Details

updateRecord

PATCH/v1/data/records/{id}

パラメーター

名前	場所	型	必須	説明
id	path	string	はい
If-Match	header	string	はい	取得したときの ETag（version）

リクエストの本文

application/json

名前	型	必須	説明
values	object	はい
reason	string

応答

• 200 — Record: レコード
• default — Problem: RFC 9457 Problem Details

getValueHistory

GET/v1/data/records/{id}/values/{field}/history

パラメーター

名前	場所	型	必須	説明
id	path	string	はい
field	path	string	はい

応答

• 200 — object: 値の履歴
• default — Problem: RFC 9457 Problem Details

confirmValue

POST/v1/data/records/{id}/values/{field}/confirm

人の確認で値を確定にする（data:values.confirm と、人の subject が要る）

パラメーター

名前	場所	型	必須	説明
id	path	string	はい
field	path	string	はい
Idempotency-Key	header	string		副作用を伴う POST ではサーバーが必須にする。SDK は無ければ自動で付けるので、型では省略できる

リクエストの本文

application/json

名前	型	必須	説明
note	string

応答

• 200 — Record: レコード
• default — Problem: RFC 9457 Problem Details

listRecordRelations

GET/v1/data/records/{id}/relations

data:records.read が必要。終わったものも含めた関係を、記録の新しい順に返す。valid_to のない行が今の関係で、 valid_from が null の行は始まった日が分からない。next_cursor を cursor に渡すと続きを返す

パラメーター

名前	場所	型	必須	説明
id	path	string	はい
type	query	string		関係の型
direction	query	in | out		このレコードから見た向き
cursor	query	string
limit	query	integer

応答

• 200 — object: 関係の履歴
• default — Problem: RFC 9457 Problem Details

createRelation

POST/v1/data/relations

多対一の有効期間のある関係は、今の関係を valid_from（なければ今日）で閉じ、新しい関係をその日から始める。 今の関係が始まった日より前の valid_from は VALIDATION_FAILED

パラメーター

名前	場所	型	必須	説明
Idempotency-Key	header	string		副作用を伴う POST ではサーバーが必須にする。SDK は無ければ自動で付けるので、型では省略できる

リクエストの本文

application/json

名前	型	必須	説明
type	string	はい
from	string	はい
to	string	はい
valid_from	string

応答

• 201 — Relation: 関係
• default — Problem: RFC 9457 Problem Details

setRelationState

POST/v1/data/relations/{id}/state

関係を確かめるか、疑いを記録する。confirmed は data:values.confirm と人の subject が要る。disputed は data:records.write で 書ける。疑いを解くのは confirmed だけで、書いただけの inferred へは戻せない。同じ状態なら何も変えない

パラメーター

名前	場所	型	必須	説明
id	path	string	はい
Idempotency-Key	header	string		副作用を伴う POST ではサーバーが必須にする。SDK は無ければ自動で付けるので、型では省略できる

リクエストの本文

application/json

名前	型	必須	説明
state	confirmed | disputed	はい
note	string

応答

• 200 — Relation: 関係
• default — Problem: RFC 9457 Problem Details

listImports

GET/v1/data/imports

応答

• 200 — object: 取り込みの記録
• default — Problem: RFC 9457 Problem Details

importCsv

POST/v1/data/imports

CSV を取り込む。見出しは項目の名前、<項目>@state で状態、@rel:<関係> で相手のキー

パラメーター

名前	場所	型	必須	説明
Idempotency-Key	header	string		副作用を伴う POST ではサーバーが必須にする。SDK は無ければ自動で付けるので、型では省略できる

リクエストの本文

application/json

名前	型	必須	説明
type	string	はい
csv	string	はい
default_state	ValueState
label	string
currency	string

応答

• 201 — Import: 取り込みの結果
• default — Problem: RFC 9457 Problem Details

listMigrations

GET/v1/data/migrations

definitions:read が必要。release_id の ReleaseBundle を有効にするときに当てる（戻す）Migration と、対象のレコードの数、 backfill の進み具合。戻す Migration が戻せなければ（値を戻す式がなければ）、有効化は止まる

パラメーター

名前	場所	型	必須	説明
release_id	query	string	はい

応答

• 200 — object: 当てる Migration
• default — Problem: RFC 9457 Problem Details

backfillMigrations

POST/v1/data/migrations/backfill

definitions:release が必要。有効化の前に、新しい値を計算して置く（レコードの値は有効化まで変えない）。limit 件まで進めて返す。 止まっても、もう一度呼べば続きから進む。有効化のときは、その後に更新されたレコードだけを計算し直す

パラメーター

名前	場所	型	必須	説明
Idempotency-Key	header	string		副作用を伴う POST ではサーバーが必須にする。SDK は無ければ自動で付けるので、型では省略できる

リクエストの本文

application/json

名前	型	必須	説明
release_id	string	はい
limit	integer

応答

• 200 — object: backfill の進み具合
• default — Problem: RFC 9457 Problem Details

listFindings

GET/v1/data/findings

data:records.read が必要。観点の規則が検出した Finding を新しい順に返す。next を cursor に渡すと続きを返す

パラメーター

名前	場所	型	必須	説明
subject	query	string		対象のレコードの ID
aspect	query	string
status	query	open | closed
cursor	query	string
limit	query	integer

応答

• 200 — object: Finding の一覧
• default — Problem: RFC 9457 Problem Details

getFinding

GET/v1/data/findings/{id}

data:records.read が必要

パラメーター

名前	場所	型	必須	説明
id	path	string	はい

応答

• 200 — Finding: Finding
• default — Problem: RFC 9457 Problem Details

closeFinding

POST/v1/data/findings/{id}/close

data:records.write が必要で、主体は人に限る（サービスアカウントと Agent は 403）。開いている Finding を人が理由を書いて閉じる。同じ事実の判定では開き直さず、 根拠の値が変わるか当たらなくなった後で検出すると新しい Finding を作る。閉じた Finding は 409 で断る

パラメーター

名前	場所	型	必須	説明
id	path	string	はい
Idempotency-Key	header	string		副作用を伴う POST ではサーバーが必須にする。SDK は無ければ自動で付けるので、型では省略できる

リクエストの本文

application/json

名前	型	必須	説明
reason	string	はい

応答

• 200 — Finding: 閉じた Finding
• default — Problem: RFC 9457 Problem Details

listAspects

GET/v1/data/aspects

data:schemas.read が必要。有効なバージョンの観点のすべて（名前・コード・題名）

応答

• 200 — object: 観点の一覧
• default — Problem: RFC 9457 Problem Details

searchKnowledge

POST/v1/data/knowledge/search

data:schemas.read が必要。有効なバージョンの Axiom と観点を、出典・確からしさ・定義のバージョン付きで引く。 query がなければ一覧を返す。mode を書かなければ、埋め込みのある環境では全文検索と意味検索を合わせ、ない環境では全文検索だけにする

リクエストの本文

application/json

名前	型	必須	説明
query	string
mode	keyword | semantic | hybrid
limit	integer
refs	string[]

応答

• 200 — object: 知識の一覧
• default — Problem: RFC 9457 Problem Details

queryOntology

POST/v1/data/ontology/query

data:records.read が必要。有効なバージョンの型と関係をたどる型付きの問い合わせ。たどれる関係は 3 段まで、1 回の応答は 100 行まで、 1 回の要求で読むレコードは 1,000 件まで。on は関係の有効な日で、今日より前なら値もその日の終わり（UTC）までに記録したものを返す。 その日の後に Migration が変えた項目は読めず、select や where に書くと CONFLICT。関係が途切れた行は unresolved に段を書く。 truncated が true なら、1 つの起点の道が上限を超えて省かれている。根拠の文書は、呼出し元が今読めるものだけ位置を返す

リクエストの本文

application/json — OntologyQuery

名前	型	必須	説明
from	object	はい	起点。id か key で 1 件に絞るか、型のレコードを順に読む
path	object[]
on	string		読む日。書かなければ今日。今日より前なら値もその日の分を読む
limit	integer
cursor	string

応答

• 200 — OntologyQueryResult: 問い合わせの結果
• default — Problem: RFC 9457 Problem Details

listOntologyActions

GET/v1/data/ontology/types/{type}/actions

data:schemas.read が必要。有効なバージョンで、その型を対象にする行為を定義の順に返す。何ができるかの説明で、ここに出ることは 実行の権限ではない。実行は tool のツールで行い、外への操作は人の承認を通す。定義にない型は 404

パラメーター

名前	場所	型	必須	説明
type	path	string	はい

応答

• 200 — OntologyActionList: 行為の一覧
• default — Problem: RFC 9457 Problem Details

resolveOntologyTerm

POST/v1/data/ontology/resolve

data:schemas.read が必要。言葉を、ID・表示名・別名が完全に一致する型と関係に対応付ける。複数に当たれば ambiguous で候補を並べ、 どれにも当たらなければ unknown を返す

リクエストの本文

application/json

名前	型	必須	説明
term	string	はい

応答

• 200 — OntologyTermResolution: 用語の候補
• default — Problem: RFC 9457 Problem Details