查询用户应用列表

查询用户应用列表

更新时间：2025-04-17

POST

https://qianfan.baidubce.com/v2/app?Action=DescribeApps

调试

该接口查询用户下的应用列表。

权限说明

调用本API，需使用API Key鉴权方式。Authorization的值为Bearer <API Key>。获取API Key流程，请查看授权。

请求参数

Headers 参数

除公共头域外，无其它特殊头域

Body 参数

marker string

起始位置

可选

maxKeys integer

数据大小，默认10，最大值100

可选

请求结构

POST /v2/app?Action=DescribeApps HTTP/1.1
HOST: qianfan.baidubce.com
Authorization: Bearer <API Key>
Content-Type: application/json
{        
    "marker": "应用起始位置id"，    
    "maxKeys": 10,    
}

示例代码

curl

curl --location 'https://qianfan.baidubce.com/v2/app?Action=DescribeApps' \
--header 'Authorization: Bearer <API Key>' \
--header 'Content-Type: application/json' \
--data '{
    "marker":"marker_id",
    "maxKeys":10
}'

返回响应

Headers 参数

除公共头域外，无其它特殊头域

返回参数

data array

应用对象列表

必选

显示子属性隐藏子属性

items object {6}

显示子属性隐藏子属性

id string

应用ID

必选

name string

应用名称

必选

appType string

应用类型。
agent为自主规划Agent
chatflow工作流Agent

必选

updateTime integer

编辑时间，格式为Unix时间戳。应用以编辑时间倒序排列

必选

description string

应用描述

必选

isPublished string

应用状态。
false:未发布
true为已发布

必选

marker string

起始位置

必选

maxKeys integer

本次查询包含的最大结果集数量

必选

requestId string

requestId

必选

nextMarker string

nextMarker下次查询的起始位置

必选

isTruncated boolean

true表示后面还有数据，false表示已经是最后一页

必选

正确响应示例错误响应示例

JSON

HTTP/1.1 200 OK

{
    "requestId": "355a4f4e-a6d8-4dec-b840-7075030c6d22",
    "marker" : "marker_id",
    "nextMarker" : "next_marker_id",
    "isTruncated" : false,
    "maxKeys" : 200,   
    "data": [
        {
            "id": "应用ID",
            "name": "name",
            "description": "应用描述",
            "appType": "应用类型",
            "isPublished": 应用状态,
            "updateTime": 编辑时间
        }
    ]
}