千问办公企业旗舰版开发者文档:上传反馈截图。
认证方式见APP开发者文档 → 认证接入。
反馈及附件按当前用户确定归属,不能通过请求参数指定他人。响应携带
请求体(含 multipart 开销)不超过 52 MiB;服务会校验实际图片内容。
HTTP 200:
401 为可信用户身份缺失或非法;403
- 接口:PUT
/api/openapi/app/v1/feedback/images - Content-Type:
multipart/form-data
资源归属
反馈及附件按当前用户确定归属,不能通过请求参数指定他人。响应携带 Cache-Control: no-store。
请求参数
| 参数 | 类型 | 必填 | 约束 |
|---|---|---|---|
| request_id | string | 是 | 1~64 位字母、数字、下划线或连字符,与随后提交反馈的 ID 一致 |
| images | file[] | 是 | 同名文件字段,1~5 张;PNG、JPEG、GIF、WebP;单张不超过 10 MiB |
响应
HTTP 200:
imageUrls 为有效期 15 分钟的签名读取地址,存储对象为私有。可能仅部分图片上传成功,success=true 表示至少一张成功,调用方需核对返回数量;全部失败时可能返回 HTTP 200、success=false、空数组。本接口不承诺重复上传幂等。
响应字段
| 字段 | 类型 | 必返 | 说明 |
|---|---|---|---|
| requestId | string | 是 | 反馈请求标识,对应提交的 request_id。 |
| success | boolean | 是 | 业务是否成功;HTTP 200 不代表该值一定为 true。 |
| result | object | 是 | 上传结果。 |
| result.imageUrls | array<string> | 是 | 成功上传图片的签名读取地址,有效期 15 分钟;可能部分成功或为空。 |
错误处理
401 为可信用户身份缺失或非法;403 audience_mismatch 为入口身份平面不匹配。400 validation_failed 为参数或文件不合法,503 feedback_unavailable 为反馈依赖不可用。不能仅凭 HTTP 200 判断提交成功,还需检查响应中的 success。
上传还可能返回 400 invalid_multipart、413 payload_too_large 或 429 限流。