Skip to main content

上传反馈截图

千问办公企业旗舰版开发者文档:上传反馈截图。

认证方式见APP开发者文档 → 认证接入。
  • 接口:PUT/api/openapi/app/v1/feedback/images
  • Content-Type:multipart/form-data

资源归属

反馈及附件按当前用户确定归属,不能通过请求参数指定他人。响应携带 Cache-Control: no-store。

请求参数

参数类型必填约束
request_idstring是1~64 位字母、数字、下划线或连字符,与随后提交反馈的 ID 一致
imagesfile[]是同名文件字段,1~5 张;PNG、JPEG、GIF、WebP;单张不超过 10 MiB
请求体(含 multipart 开销)不超过 52 MiB;服务会校验实际图片内容。

响应

HTTP 200:
{
  "requestId": "feedback-example-001",
  "success": true,
  "result": {
    "imageUrls": [
      "https://example.invalid/screenshot-signed-url"
    ]
  }
}
imageUrls 为有效期 15 分钟的签名读取地址,存储对象为私有。可能仅部分图片上传成功,success=true 表示至少一张成功,调用方需核对返回数量;全部失败时可能返回 HTTP 200、success=false、空数组。本接口不承诺重复上传幂等。

响应字段

字段类型必返说明
requestIdstring是反馈请求标识,对应提交的 request_id。
successboolean是业务是否成功;HTTP 200 不代表该值一定为 true。
resultobject是上传结果。
result.imageUrlsarray<string>是成功上传图片的签名读取地址,有效期 15 分钟;可能部分成功或为空。

错误处理

401 为可信用户身份缺失或非法;403 audience_mismatch 为入口身份平面不匹配。400 validation_failed 为参数或文件不合法,503 feedback_unavailable 为反馈依赖不可用。不能仅凭 HTTP 200 判断提交成功,还需检查响应中的 success。 上传还可能返回 400 invalid_multipart、413 payload_too_large 或 429 限流。