评估报告回填:CLI --push 推送落点——报告行插入 + 池条目 evaluation 投影同请求联动(恒显式置 evaluated = 重评完成合法置回径;机械律唯在 admin PUT evaluation 手工回填面,两写面正交);鉴权判定序 = x-tansr-admin-key 在场走 admin 链(ADMIN_OPS,任意 scope 档可回填),否则恒 Bearer+control+org 语境(x-tansr-org,owner/admin)本户/本 org 档限定(platform/他人档 404 不泄露);幂等 = 同 (profileId, reportRef) 重提 200 返回既有行恒不重写条目不重复审计(判重键不含协议);conclusion 是证据不是权力(恒不写 tier);报告行存提交方 reportRef 原文、条目 evaluation.reportRef 指向报告 id(两级引用,平台可解引用);body.protocol 可选 coding|app 缺省 coding——报告行落协议,读面 evaluation.byProtocol 每协议各取最近一次,四键仍为最近一次任一协议;app 协议报告 = bundle adjudicator[s].evidenceFingerprint 数据源(恒指应用协议证据),对 app 报告恒失效 bundle(含相对条目乱序径);写恒审计 adjudicator_pool.evaluation_report(detail.protocol)+ bundle 失效
POST
/v1/adjudicators/{id}/evaluation-report
Authorizations
Section titled “Authorizations”Parameters
Section titled “Parameters”Header Parameters
Section titled “Header Parameters”x-tansr-org
string
Org 作用域声明(org 公开 id);服务端校验成员资格与角色,非成员恒 404、角色不够 403
Request Bodyrequired
Section titled “Request Bodyrequired”Media typeapplication/json
object
binding
required
评估绑定键(stage1×stage2 id 串;single-stage 两位同值)
string
protocolFingerprint
required
评估时点协议指纹(联动条目 evaluation.fingerprint)
string
gatesProfile
required
门矩阵版本(tier-gates-v1 …)
string
reportRef
required
提交方报告存档引用(CLI 落盘路径/外部 URL;幂等判重键之一)
string
summary
报告摘要体(宽松;harness summary+qualification 两段)
object
evaluatedAt
缺省 = 服务端 now
string format: date-time
Responses
Section titled “Responses”幂等命中(同 reportRef 既有行;条目/审计恒不重写)
Media typeapplication/json
object
report
required
object
id
required
string
binding
required
string
protocolFingerprint
required
string
gatesProfile
required
string
reportRef
required
string
submittedBy
required
string
evaluatedAt
required
string
createdAt
required
string
Example
{ "report": { "mode": "two-stage", "protocol": "coding", "conclusion": "low" }}已回填(首提)
Media typeapplication/json
object
report
required
object
id
required
string
binding
required
string
protocolFingerprint
required
string
gatesProfile
required
string
reportRef
required
string
submittedBy
required
string
evaluatedAt
required
string
createdAt
required
string
Example
{ "report": { "mode": "two-stage", "protocol": "coding", "conclusion": "low" }}Bad_request(evaluatedAt 非 ISO 8601)
Media typeapplication/json
object
error
required
object
code
required
错误码注册表单源派生(src/http/errors.ts ERROR_CODES;码稳定,消费方按码翻译)
string
message
required
string
requestId
required
string
detail
object
Example
{ "error": { "code": "adjudicator_not_authorized" }}Not_found(Bearer 链:platform/他人档恒 404 不泄露;admin 链:条目不存在)
Media typeapplication/json
object
error
required
object
code
required
错误码注册表单源派生(src/http/errors.ts ERROR_CODES;码稳定,消费方按码翻译)
string
message
required
string
requestId
required
string
detail
object
Example
{ "error": { "code": "adjudicator_not_authorized" }}本文是否有帮助?
感谢反馈,我们会持续改进这篇文章。