# 分页查询行业专家

`GET` `/api/hub/agent/list`

按市场类型查询已发布的行业专家。OFFICIAL表示官方推荐，APP_CUSTOM表示当前应用的我的市场；支持按当前市场标签和关键词过滤，返回当前市场可用标签、累计安装次数和当前主体是否已安装。

## 请求参数

### 请求头参数

| 参数名 | 类型 | 必填 | 说明 |
|--------|------|------|------|
| X-Principal-Id | integer | 否 | 身份主体ID（Long类型）。通过API访问时必须传递以标识操作主体；通过页面访问时无需传递。可通过「身份主体」模块的创建接口获取。 |

### Query 参数

| 参数名 | 类型 | 必填 | 说明 |
|--------|------|------|------|
| registryType | string | 是 | 市场类型，可选值：OFFICIAL、APP_CUSTOM |
| tagIds | array | 否 | 当前市场的标签ID列表，最多选择50个；多选时匹配任一标签 |
| keyword | string | 否 | 关键词，匹配专家名称或描述 |
| page | integer | 否 | 页码，从1开始 |
| pageSize | integer | 否 | 每页记录数，取值范围1~100 |

## 响应

### 200

| 参数名 | 类型 | 说明 |
|--------|------|------|
| httpStatusCode | integer | HTTP状态码 |
| message | string | 响应消息 |
| data | HubPageResultAgentHubItemVO | 响应数据 |
|     registryType | string | 当前市场类型，可选值：OFFICIAL、APP_CUSTOM |
|     availableTags | array | 当前市场可用于筛选的启用标签 |
|         id | integer | 标签ID |
|         tagName | string | 标签名称 |
|     items | array | 数据列表 |
|         id | integer | 专家市场条目ID |
|         agentName | string | 专家展示名称 |
|         agentDescription | string | 专家展示描述 |
|         appliedCount | integer | 该专家累计安装次数 |
|         isApplied | boolean | 当前身份主体是否已经安装该专家 |
|         avatarUrl | string | 专家头像访问地址 |
|         creatorNickname | string | 创建者昵称 |
|         tags | array | 专家标签列表 |
|             id | integer | 标签ID |
|             tagName | string | 标签名称 |
|         gmtCreate | string | 创建时间，格式：yyyy-MM-dd HH:mm:ss |
|     total | integer | 总记录数 |
|     page | integer | 当前页码，从1开始 |
|     pageSize | integer | 每页记录数，取值范围1~100 |
|     totalPages | integer | 总页数 |
| success | boolean | 是否成功 |
| requestId | string | 上游请求ID，用于跨系统链路追踪排查问题 |
| errCode | string | 上游错误码，前端可据此做特殊UI处理 |

### 400

| 参数名 | 类型 | 说明 |
|--------|------|------|
| httpStatusCode | integer | HTTP状态码 |
| message | string | 响应消息 |
| data | object | 响应数据 |
| success | boolean | 是否成功 |
| requestId | string | 上游请求ID，用于跨系统链路追踪排查问题 |
| errCode | string | 上游错误码，前端可据此做特殊UI处理 |

### 500

| 参数名 | 类型 | 说明 |
|--------|------|------|
| httpStatusCode | integer | HTTP状态码 |
| message | string | 响应消息 |
| data | object | 响应数据 |
| success | boolean | 是否成功 |
| requestId | string | 上游请求ID，用于跨系统链路追踪排查问题 |
| errCode | string | 上游错误码，前端可据此做特殊UI处理 |