类目管理

查询类目列表

查询业务空间下的类目列表，支持按类型、名称、父类目和连接器 ID 过滤

POST

/api/v1/connector/dash/listCategory

cURL

curl -X POST "https://{workspaceId}.cn-beijing.maas.aliyuncs.com/api/v1/connector/dash/listCategory" \
  -H "Authorization: Bearer $DASHSCOPE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "UNSTRUCTURED"
  }'

{
  "code": "Success",
  "message": "",
  "messageUnmodified": false,
  "requestId": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
  "data": {
    "hasNext": false,
    "maxResult": 20,
    "totalCount": 2,
    "maxId": 100602,
    "categoryList": [
      {
        "categoryId": "cate_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx_xxxxxx",
        "categoryName": "cscd",
        "type": "UNSTRUCTURED",
        "isDefault": false
      }
    ]
  },
  "status": 200
}

分页参数名为 maxResult（单数），传入 maxResults（复数）会被静默忽略，按默认 20 返回。

首次查询不传 nextToken；翻页时传入上一页响应返回的 nextToken。

拿到 categoryId 后，前往查询文件列表查看该类目下的文件。

Authorizations

string

header

required

DashScope API Key，在控制台 API Key 页面（https://agent.console.aliyun.com/settings/apikey）获取。

Body

application/json

enum<string>

required

类目类型。当前仅支持 UNSTRUCTURED（非结构化数据类目）。

Available options:UNSTRUCTURED

Example:UNSTRUCTURED

string

父类目 ID，用于查询子类目。

string

类目名称，精确匹配。

string

连接器 ID，按连接器过滤类目。

string

分页游标，首次查询不传；翻页时传入上一页响应返回的 nextToken 值。

integer

default20

每页返回的类目数量，默认 20。注意参数名为 maxResult（单数），传入 maxResults（复数）会被静默忽略。

Response

200-application/json

string

响应码，成功时为 Success。

integer

HTTP 状态码。

string

请求唯一标识，排查问题时请提供此 ID。

object

Show child attributes

object[]

类目列表。

Show child attributes

string

类目 ID。

string

类目名称。

enum<string>

类目类型。

Available options:UNSTRUCTURED

boolean

是否为默认类目。

cURL

curl -X POST "https://{workspaceId}.cn-beijing.maas.aliyuncs.com/api/v1/connector/dash/listCategory" \
  -H "Authorization: Bearer $DASHSCOPE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "UNSTRUCTURED"
  }'

{
  "code": "Success",
  "message": "",
  "messageUnmodified": false,
  "requestId": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
  "data": {
    "hasNext": false,
    "maxResult": 20,
    "totalCount": 2,
    "maxId": 100602,
    "categoryList": [
      {
        "categoryId": "cate_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx_xxxxxx",
        "categoryName": "cscd",
        "type": "UNSTRUCTURED",
        "isDefault": false
      }
    ]
  },
  "status": 200
}