请求与响应
统一的请求格式、分页、金额与响应封装。
请求与响应
基础路径为 /api/v1。成功 JSON 为 { data, meta?, requestId }；错误为 { error: { code, message, details? }, requestId }。X-Request-Id 也会返回请求编号。
JSON 写请求使用 Content-Type: application/json。无参数的 POST 和 DELETE 也传空对象 {}。未知字段会被拒绝，业务 ID 均放在路径，不在请求中提交 actorId 或 role。
分页与字段类型
列表使用 page（默认 1）与 pageSize（默认 20，上限 100），meta 返回 page、pageSize、total。超出末页返回空数组，不自动切换页码。
响应时间使用 ISO 8601，金额为十进制字符串。各接口的日期输入格式见参数说明。
列表中的对象包含显式公开字段，详情按资源补充公司资料、工单事件或媒体。附件引用附带 downloadUrl，调用时继续使用 Bearer Key。