查询技能上架申请接口

查询成员提交的技能上架申请,查看提交时的资源快照、审批状态及提交人信息。取得 reviewId 后可调用对应的审批接口。

所需权限

所需权限资源Scope资源服务
技能上传审批读取(读取)skills-upload-reviewsadmin.v1.skills-upload-reviews.readqwenwork-biz-service

GET /api/openapi/v1/skill-upload-reviews

认证与请求头

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

名称位置类型必填说明示例
Authorizationheaderstring应用 API Key,使用 Bearer 方式传递。Bearer qwk_\\*
X-Request-Idheaderstring可选的调用追踪标识;未传入时由服务端生成。req-20260831-001

请求参数

名称位置类型必填说明示例
pagequeryinteger · int64请求的页码,从 1 开始。 默认值:1。 最小值:1。1
page_sizequeryinteger · int64每页返回的记录数量。 默认值:20。 最小值:1。 最大值:100。20

请求示例

将 <BASE_URL> 替换为企业部署的千问办公 API 服务地址,并填写实际参数。示例中的占位值不能直接用于请求。

curl --request GET --url '<BASE_URL>/api/openapi/v1/skill-upload-reviews?page=1&page_size=20' --header 'Authorization: Bearer <API_KEY>'

响应

200 请求成功,返回当前或更新后的数据。

名称类型必填说明示例
itemsarray | null符合查询条件的当前页记录列表。[{"created_at":"2026-08-27T10:00:00Z","id":"<string>","reject_reason":"<string>","resource_id":"<string>","resource_identity":"<string>","resource_type":"<string>","reviewed_at":"2026-08-27T10:00:00Z","reviewer_email":"<string>","reviewer_id":"<string>","reviewer_name":"<string>","snapshot":"<string>","status":"<string>","submitted_by":"<string>","submitted_by_email":"<string>","submitted_by_name":"<string>","updated_at":"2026-08-27T10:00:00Z"}]
items[].created_atstring · date-time此记录的创建时间。"2026-08-27T10:00:00Z"
items[].idstring此记录的唯一标识,查询、更新或删除对应记录时使用。"<string>"
items[].reject_reasonstring审批被拒绝时记录的原因。"<string>"
items[].resource_idstring审批关联的资源标识。"<string>"
items[].resource_identitystring审批中用于识别提交资源的身份值。"<string>"
items[].resource_typestring此次记录涉及的资源类型。"<string>"
items[].reviewed_atstring · date-time完成审批的时间;尚未审批时为空。"2026-08-27T10:00:00Z"
items[].reviewer_emailstring审批人的邮箱。"<string>"
items[].reviewer_idstring审批人的用户标识。"<string>"
items[].reviewer_namestring审批人的姓名。"<string>"
items[].snapshotany提交审批时保存的资源信息快照。"<string>"
items[].statusstring此记录当前所处的状态。"<string>"
items[].submitted_bystring提交人的用户标识。"<string>"
items[].submitted_by_emailstring提交人的邮箱。"<string>"
items[].submitted_by_namestring提交人的姓名。"<string>"
items[].updated_atstring · date-time此记录最后一次更新的时间。"2026-08-27T10:00:00Z"
next_cursorstring继续读取下一批结果时使用的游标;没有后续结果时为空。"<string>"
total_rowsinteger · int64符合查询条件的记录总数。0
{
  "items": [
    {
      "created_at": "2026-08-27T10:00:00Z",
      "id": "<string>",
      "reject_reason": "<string>",
      "resource_id": "<string>",
      "resource_identity": "<string>",
      "resource_type": "<string>",
      "reviewed_at": "2026-08-27T10:00:00Z",
      "reviewer_email": "<string>",
      "reviewer_id": "<string>",
      "reviewer_name": "<string>",
      "snapshot": "<string>",
      "status": "<string>",
      "submitted_by": "<string>",
      "submitted_by_email": "<string>",
      "submitted_by_name": "<string>",
      "updated_at": "2026-08-27T10:00:00Z"
    }
  ],
  "next_cursor": "<string>",
  "total_rows": 0
}

default 请求失败,返回错误码和错误详情。

名称类型必填说明示例
codestring用于程序判断错误原因的稳定业务错误码。"<string>"
detailstring便于阅读的错误说明。"<string>"
detailsOpenapiErrorDetails字段校验失败时的详细信息。{"field":"<string>","reason":"<string>","suggestion":"<string>"}
details.fieldstring未通过校验的请求字段。"<string>"
details.reasonstring稳定的校验失败原因,用于判断字段为何不合法。"<string>"
details.suggestionstring建议采用的规范化字段值。"<string>"
errorstring稳定的 HTTP 错误类型。"<string>"
{
  "code": "<string>",
  "detail": "<string>",
  "details": {
    "field": "<string>",
    "reason": "<string>",
    "suggestion": "<string>"
  },
  "error": "<string>"
}