环境与状态码说明

环境与地址

说明	值
后端服务根路径（prod-api）	https://office.zjdiante.com/prod-api
开放平台 v1 前缀	`https://office.zjdiante.com/prod-api/api/platform/v1`
鉴权	请求头 `X-App-Key`：开放平台密钥；部分网关要求同时传 `request-type: app`

本文件仅收录约定的 v1 接口；站内其它管理接口不在此清单内。

响应体一般为 RuoYi AjaxResult 结构：

字段	说明
`code`	外层业务码；200 表示请求被框架正常处理（与 HTTP 状态码常一致）
`msg`	提示信息；失败时为错误说明
`data`	业务数据；失败时可能为 `null` 或无 `data`

常见 HTTP 状态：401 未鉴权、403 无权限、404 路径不存在、500 服务端异常等（以网关与全局异常处理为准）。

与外层 AjaxResult.code 不同维度：在 HTTP 200 且外层成功时，仍可通过 data.bizCode 区分开放平台细分结果（见各接口响应模型）。

bizCode	含义
0	成功：已按价目扣费（或等价流程），工具返回有效 URL 或文本
101	异步任务已受理，请凭 `taskId` 轮询 `GET .../tasks/{taskId}`
51001	接口未开放或未配置单价
51002	接口单价配置异常
51003	计费数量须大于 0
51004	扣费金额异常
62001	扣费后工具返回的 URL 与文本均为空
62002	任务执行失败（异常、超时回写等）