Appearance
应用列表
分页查询当前工作空间下已发布的应用列表,支持按应用类型和关键词筛选。
- 接口路径:
POST /v1/openapi/apps
请求头
| 参数名 | 必填 | 说明 |
|---|---|---|
| Content-Type | 是 | application/json |
| Authorization | 是 | 鉴权凭证,格式 Bearer sk_xxx |
请求参数
json
{
"app_type": 2, // 应用类型筛选(可选)
"keyword": "", // 名称关键词筛选(可选)
"page": 1, // 页码,缺省 1
"page_size": 10 // 每页条数,缺省 10
}| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| app_type | uint8 | 否 | 应用类型筛选,见下表;不传返回全部类型 |
| keyword | string | 否 | 按应用名称模糊筛选 |
| page | int | 否 | 页码,缺省 1 |
| page_size | int | 否 | 每页条数,缺省 10 |
应用类型(app_type):
| 值 | 类型 | 说明 |
|---|---|---|
| 1 | claw | Claw 助手 |
| 2 | agent | Agent 助手 |
| 3 | agent_lite | AgentLite 助手 |
| 4 | text_completion | 文本生成 |
| 5 | chat_flow | ChatFlow |
返回数据
json
{
"code": 200,
"message": "success",
"data": {
"total": 12,
"record": [
{
"id": "01965de1-1920-7fe4-aa38-2e6836c46f22", // 应用ID
"name": "医疗问答助手", // 应用名称
"description": "面向门诊的智能问答", // 应用描述
"icon": "robot", // 图标
"icon_background": "#E0F2FE", // 图标背景色
"icon_color": "#0284C7", // 图标颜色
"app_type": 2, // 应用类型
"app_source": 1, // 应用来源
"status": 1, // 启用状态
"created_at": "2025-04-22 22:22:34", // 创建时间
"updated_at": "2025-04-22 22:30:11" // 更新时间
}
]
}
}| 字段 | 类型 | 说明 |
|---|---|---|
| id | string(uuid) | 应用 ID |
| name | string | 应用名称 |
| description | string | 应用描述 |
| icon | string | 图标标识 |
| icon_background | string | 图标背景色 |
| icon_color | string | 图标颜色 |
| app_type | uint8 | 应用类型,见上表 |
| app_source | uint8 | 应用来源:1-自建、2-Dify、3-FastGPT |
| status | uint8 | 启用状态:0-禁用、1-启用 |
| created_at | string | 创建时间,YYYY-MM-DD HH:mm:ss |
| updated_at | string | 更新时间,YYYY-MM-DD HH:mm:ss |
