查询用户应用列表
更新时间：2025-02-18
接口描述
该接口查询用户下的应用列表。
在线调试
百度智能云千帆提供了 API在线调试平台-示例代码 ，用于帮助开发者调试接口，平台集成快速检索、查看开发文档、查看在线调用的请求内容和返回结果、复制和下载示例代码等功能，支持Python、Java、PHP、C#、Go、Node.js、C++ 7种主流语言示例代码自动生成。
权限说明
Authorization需要填写密钥。
接口定义
| Path | /v2/app?Action=DescribeApps |
|---|---|
| Method | POST |
| Content-Type | application/json |
| Authorization | 请求签名(Bearer <AppBuilder API Key>) |
请求结构
Plain Text
1POST /v2/app?Action=DescribeApps HTTP/1.1
2HOST: qianfan.baidubce.com
3Authorization: Bearer <AppBuilder API Key>
4Content-Type: application/json
5{
6 "marker": "应用起始位置id"，
7 "maxKeys": 10,
8}请求头域
除公共头域外，无其它特殊头域。
请求参数
| 字段 | 类型 | 是否必须 | 说明 |
|---|---|---|---|
| marker | string | 否 | 起始位置 |
| maxKeys | integer | 否 | 数据大小，默认10，最大值100 |
响应头域
除公共头域外，无其它特殊头域。
响应参数
| 字段 | 类型 | 必然存在 | 说明 |
|---|---|---|---|
| requestId | string | 是 | requestId |
| marker | string | 是 | 起始位置 |
| isTruncated | bool | 是 | true表示后面还有数据，false表示已经是最后一页 |
| nextMarker | string | 是 | nextMarker下次查询的起始位置 |
| maxKeys | int | 是 | 本次查询包含的最大结果集数量 |
| data | list[object] | 是 | 应用对象列表 |
应用对象
| 字段 | 类型 | 必然存在 | 说明 |
|---|---|---|---|
| id | string | 是 | 应用ID |
| name | string | 是 | 应用名称 |
| description | string | 是 | 应用描述 |
| appType | string | 是 | 应用类型。agent为自主规划Agentchatflow工作流Agent |
| isPublished | string | 是 | 应用状态。false:未发布true为已发布 |
| updateTime | int | 是 | 编辑时间，格式为Unix时间戳。应用以编辑时间倒序排列 |
请求curl 示例
Plain Text
1curl --location 'https://qianfan.baidubce.com/v2/app?Action=DescribeApps' \
2--header 'Authorization: Bearer <AppBuilder API Key>' \
3--header 'Content-Type: application/json' \
4--data '{
5 "marker":"marker_id",
6 "maxKeys":10
7}'正确响应示例
Plain Text
1HTTP/1.1 200 OK
2
3{
4 "requestId": "355a4f4e-a6d8-4dec-b840-7075030c6d22",
5 "marker" : "marker_id",
6 "nextMarker" : "next_marker_id",
7 "isTruncated" : false,
8 "maxKeys" : 200,
9 "data": [
10 {
11 "id": "应用ID",
12 "name": "name",
13 "description": "应用描述",
14 "appType": "应用类型",
15 "isPublished": 应用状态,
16 "updateTime": 编辑时间
17 }
18 ]
19}错误响应示例
Plain Text
1HTTP/1.1 401
2{
3 "requestId": "ae2225f7-1c2e-427a-a1ad-5413b762957d",
4 "code": "PermissionDeniedError",
5 "message": "没有权限"
6}