图纸发布管理
8 个接口(读 2 / 写 6) · 其中 5 个高危 · 凭证范围:查询需 project:read,写操作需 project:write
| 接口 | 编码 | 后端签名 | |
|---|---|---|---|
| POST 高危 | 取消发布(CREATED/CHECK_PASS/PENDING → CANCELED) | project.drawing.releases.cancel | /v1/drawing/releases/cancel |
| POST 高危 | 执行发布前检查(CREATED → CHECKING → CHECK_PASS/FAILED) | project.drawing.releases.check | /v1/drawing/releases/check |
| POST 高危 | 确认发布(仅 APPROVED → PUBLISHED,原子事务) | project.drawing.releases.confirm-publish | /v1/drawing/releases/confirm-publish |
| POST | 新建发布单(PENDING) | project.drawing.releases.create | /v1/drawing/releases/create |
| GET | 发布单详情 | project.drawing.releases.detail | /v1/drawing/releases/detail |
| POST | 分页查询发布单 | project.drawing.releases.page | /v1/drawing/releases/page |
| POST 高危 | 提交审批(CHECK_PASS → PENDING,发起统一 workflow) | project.drawing.releases.submit-approval | /v1/drawing/releases/submit-approval |
| POST 高危 | 更新发布设置(仅 CREATED/CHECK_FAIL 状态可改) | project.drawing.releases.update-settings | /v1/drawing/releases/update-settings |
调用协议(各页通用)
本实体接口统一通过 POST https://open.risemap.cn/v1/api/invoke 调用,用 apiCode 指定接口。
JSON 响应为统一信封 { code, message, data },文件接口成功时直接返回文件;
错误码见错误码说明;凭证获取与调用协议见开放接口清单。
示例中的鉴权头为 OAuth 访问令牌形态;AppKey 集成商换成 -H "X-App-Key: <appKey>" -H "X-App-Secret: <appSecret>" 即可,其余不变。
所有调用以绑定员工身份执行,员工须具备对应主站功能权限(默认按后端接口 URL 自动对照,个别接口单独标注权限码)。
本页由接口注册表与后端接口规格自动生成。