获取用户创建的AI助理列表新版SDK
更新于 2024-12-12获取用户创建的AI助理列表,需要传入助理创建者的用户 ID (Union ID)。
权限
要调用此API,需要以下权限之一。
应用类型 | 是否支持 | 权限 | API Explorer调试 |
企业内部应用 | 支持 | AI助理管理的读取权限 | |
第三方企业应用 | 支持 | AI助理管理的读取权限 |
请求方法
Loading...
Header参数
名称 | 类型 | 是否必填 | 描述 |
x-acs-dingtalk-access-token | String | 是 | 调用该接口的访问凭证:
|
Query参数
名称 | 类型 | 是否必填 | 描述 |
unionId | String | 是 | 助理创建者的 Union ID。 |
cursor | Long | 否 | 分页查询的游标,下一次游标值通过该接口的响应中 nextCursor 参数确定。 |
pageSize | Integer | 是 | 每页的元素个数。 |
返回参数
名称 | 类型 | 描述 |
hasMore | Boolean | 是否有下一页。 |
nextCursor | Long | 下一页的游标值。 |
totalCount | Integer | 结果总数。 |
list | Array | 助理列表。 |
assistantId | String | AI 助理的唯一标识符。 |
name | String | 助理的名称。 |
description | String | 助理的描述。 |
icon | String | 助理的头像,采用钉钉多媒体文件标识符 Media ID 表示。 |
creatorUnionId | String | 助理创建者 ID(Union ID)。 |
createdAt | Long | 助理的创建时间,Unix 时间戳格式,单位秒。 |
示例
请求示例
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
返回示例
Loading...
错误码
HttpCode | 错误码 | 错误信息 | 说明 |
400 | invalid.parameter | 参数错误 | 参数错误 |
500 | system.error | 系统异常 | 系统异常 |