元话METACHINA
进入工作台

05 / BUILD WITH DECISION OS

同一套判断，
接入你的流程。

为人与 Agent 提供同源 /api/v1。从判断、报价到决策档案，以明确的请求与状态衔接业务流程。

浏览接口 ↓管理 API 密钥

01 / 接入约定

把状态与边界，写进集成。

SESSION

同源会话

邮箱与密码共用账户。浏览器使用同源 cookie；原生客户端使用 Bearer 会话，Android / iOS 分别使用 Keystore / Keychain 保存。

IDEMPOTENCY

幂等写入

创建判断、报价、订单、付款、复盘、密钥、企业评估和删除申请的 POST 带 Idempotency-Key。

ERROR CONTRACT

明确错误

错误形状为 error.code、error.message 与 request_id。超时记为 TIMEOUT，不以演示结果替代失败。

02 / API REFERENCE

从输入，到结果回写。

以下路径均以 /api/v1 为前缀。启用状态与限额以当前配置为准。

向左右滑动，查看完整接口表。

方法路径说明
GET/config身份模式、注册与测试开关、支付、定价、限额、PDF、密钥范围
POST/auth/registeremail、password、label?、terms_accepted:true
POST/auth/loginemail、password
POST/auth/logout成功后才结束本页会话。失败则保持登录
GET/me{ user }
POST/auth/test仅当配置打开内测。label、access_code
POST/decidestate 字符串，questions 含 criteria
POST/quotes深决策模型报价、候选分布、版本与有效期
POST / GET/pricing/quotes · /pricing/quotes/:id按决策类型选择模型价格档位，保留定价审计；不代表扣款
POST/analysis/value · /rank · /valuationValue 分布、Rank 两两比较、通用企业三法估值；显式来源与时点
GET/analysis/runs · /analysis/runs/:id本账户数值研究记录及定价依据
GET POST / PATCH/skill-requests · /skill-requests/:id桌面待核对请求；只有用户会话能关联匹配的报价、订单或取消
GET POST/industrial/sources · /events · /evaluate数据源、单位校验、遥测事件与确定性阈值提示
GET POST/private/datasets · /training/jobs · /models · /calibrate私有环境的数据集、概率校准训练和模型应用；仅本地适配提供
POST/orders{ quote_id } → { order }
POST/orders/:id/checkout{ url, session_id, payment_mode }。只接受 https://checkout.stripe.com
POST/orders/:id/simulate-payment仅显式测试模式，且要二次确认
GET/orders · /orders/:id列表与 { order, task, refund }
GET/decisions · /decisions/:id档案、book、files。files 为 {json, pdf}，路径可为 null
GET/decisions/:id/json · /pdf登录后下载
POST/decisions/:id/outcomeobserved、evidence
GET/calibrationlive 与 demo 分开。null 表示暂无
GET/usage · /billing不发明余额
GET POST/keys创建返回 {id, key, prefix, scopes}。完整 key 只展示一次
DELETE/keys/:id吊销。列表只保留 prefix
GET POST/notificationsread_at；标记已读
POST/enterprise/assessments需 cookie。company、scenario、contact_email，可选 contact_name、data_location、existing_systems、scale、constraints。返回 status received
GET/account/export登录后下载 JSON。不写入 localStorage
GET PUT/account/notification-prefs{disable_all:boolean, updated_at:null|string}。PUT 正文 {disable_all}
GET POST/account/delete-requeststatus 为 none 或 requested，completed 为 false。POST {} 带 Idempotency-Key。不表示已删除

03 / 客户端约定

数据怎样保存，
请求怎样计量。

  • 幂等摘要浏览器只把方法、路径与正文的 SHA-256 当作缓存键，不保存原始正文。同一摘要复用键，正文改变时换新键。
  • 日期与交付文件due_at 在发送前转成带时区的 ISO 时间。files 为 {json, pdf}，值为路径或 null；旧文件数组仍可展示。
  • 请求耗时收到响应头时记下耗时，不含读取正文。超时计入网络失败；用户取消轮询不记入，也不展示错误。

04 / OPENAPI SPECIFICATION

读取接口规范。

点击按钮读取 GET /api/v1/openapi.json，以实际响应为准。