用户问题反馈读取

• Scope：admin.v1.client-feedback.read
• 权限项：用户问题反馈读取（client-feedback）
• 权限类型：读取
• 接口：GET/api/openapi/v1/client-feedback

认证与请求头

使用应用 API Key 调用。当前接口只校验上方独立 Scope；读取、管理与执行权限互不隐含。

请求参数

请求示例

cURL

curl --request GET \
  --url 'https://example.invalid/api/openapi/v1/client-feedback?from=<from>&to=<to>&cursor=<cursor>&page_size=20' \
  --header 'Authorization: Bearer <API_KEY>'

文件链接有效期与转存

截图的 screenshots[].url、screenshots[].download_url 和诊断日志的 diagnostic.url 均为临时签名链接，不保证长期可用。各文件链接的到期时间以对应的 expires_at 为准，不要在对接程序中硬编码有效时长。

拉取数据后，应及时在 expires_at 之前下载需要保留的文件，并转存至对接方自有的对象存储或文件存储；保存反馈 id 与转存文件的关联关系。不能只保存接口返回的链接作为长期文件地址。

下载文件时直接请求返回的完整链接，无需携带 OpenAPI API Key，也不要把 API Key 发送给对象存储。链接包含临时访问签名，应按凭据保护，避免写入公开日志。

若下载前链接已过期，可使用原 from、to 时间区间重新拉取并按 id 去重，获取新链接后立即下载。刷新链接不代表文件永久保留；原文件不存在时不能依赖重新拉取恢复文件。

diagnostic 在没有诊断文件时为 null；有文件时为包含 url、name 和 expires_at 的对象。截图与诊断日志均遵循上述下载和转存要求。

响应

200 OK

响应示例

{
  "has_more": false,
  "items": [
    {
      "can_report": false,
      "created_at": "2026-08-27T10:00:00Z",
      "description": "<string>",
      "diagnostic": {
        "url": "<signed-url>",
        "name": "diagnostic.zip",
        "expires_at": "2026-08-27T10:15:00Z"
      },
      "diagnostic_available": true,
      "diagnostic_filename": "<string>",
      "id": "<string>",
      "official_issue_id": "<string>",
      "org_id": "<string>",
      "read_at": "2026-08-27T10:00:00Z",
      "read_by": "<string>",
      "report_status": "<string>",
      "reported_at": "2026-08-27T10:00:00Z",
      "screenshots": [
        {
          "download_url": "<string>",
          "expires_at": "2026-08-27T10:00:00Z",
          "name": "<string>",
          "url": "<string>"
        }
      ],
      "status": "unread",
      "updated_at": "2026-08-27T10:00:00Z",
      "updated_by": "<string>",
      "updated_by_email": "<string>",
      "updated_by_name": "<string>",
      "user_email": "<string>",
      "user_id": "<string>",
      "user_name": "<string>"
    }
  ],
  "next_cursor": "<string>",
  "official_reporting_enabled": false
}

default Flat business error

响应示例

{
  "code": "<string>",
  "detail": "<string>",
  "details": {
    "field": "<string>",
    "reason": "<string>",
    "suggestion": "<string>"
  },
  "error": "<string>"
}