查询真人认证会话列表

GET /api/volc-user/visual-validate-sessions

分页查询当前用户的认证会话，包含两种创建模式，按创建记录 ID 倒序返回。

鉴权说明

用户控制台接口，使用登录会话 Cookie，或请求头 Authorization: <access_token>。访问令牌由 生成访问令牌 获取，与模型调用使用的 sk- 密钥不同。

请求参数

参数名	类型	必选	说明
pageNumber	integer	可选	页码，从 1 开始，默认 1
pageSize	integer	可选	每页数量，默认 20；小于 1 或大于 100 时回退为 20
status	string	可选	按状态筛选：Pending、Processing、Succeeded、Failed、Expired；不传则查询全部

请求示例

GET /api/volc-user/visual-validate-sessions?pageNumber=1&pageSize=20&status=Succeeded
Authorization: <access_token>

响应字段（200）

字段名	类型	说明
success	boolean	业务是否成功；HTTP 200 仍需检查此字段
message	string	提示信息，成功时为空字符串
data	object	成功时的响应数据
data.totalCount	integer	总数量
data.pageNumber	integer	当前页码
data.pageSize	integer	每页数量
data.items	array<object>	当前页记录
data.items[].sessionId	string	平台认证会话 ID，用于查询认证结果
data.items[].status	string	Pending、Processing、Succeeded、Failed、Expired，见 接入流程
data.items[].h5Link	string	仅在会话为 Pending 且未过期时返回；交给本人打开完成认证
data.items[].expiresAt	integer	认证链接过期时间，Unix 秒；当前会话有效期为创建后 120 秒
data.items[].groupId	string	认证成功后生成的平台素材组 ID；无值时省略，查询时已删除的素材组也不再返回
data.items[].resultCode	string	H5 认证结果码，有值时返回；成功为 10000
data.items[].errorCode	string	错误码，有值时返回
data.items[].errorMessage	string	错误说明，有值时返回
data.items[].createTime	integer	创建时间，Unix 秒
data.items[].updateTime	integer	更新时间，Unix 秒

响应示例

{
  "success": true,
  "message": "",
  "data": {
    "totalCount": 1,
    "pageNumber": 1,
    "pageSize": 20,
    "items": [
      {
        "sessionId": "vvs-example",
        "status": "Succeeded",
        "expiresAt": 1792022520,
        "createTime": 1792022400,
        "updateTime": 1792022430,
        "groupId": "group-example",
        "resultCode": "10000"
      }
    ]
  }
}

列表中的会话 ID 字段统一为 sessionId。已删除的素材组不会再通过 groupId 返回，但认证历史会保留。