知识库知识库外部开放接口
获取空间元数据列表
返回指定空间下配置的元数据字段。
请求体
| 名称 | 类型 | 必填 | 描述 | 示例值 |
|---|---|---|---|---|
| spaceId | int64 | 是 | 知识库空间 ID。 | 123456 |
返回参数
| 名称 | 类型 | 描述 | 示例值 |
|---|---|---|---|
| code | int32 | 业务响应码。200 表示成功;失败时为 RetCode 中定义的业务码。 | 200 |
| msg | string | 响应说明。成功通常为 ok;失败时为错误原因。 | ok |
| message | string | 兼容字段,部分异常场景可能返回错误说明。 | |
| data | object[] | 空间属性列表。 | |
| └id | int64 | 属性 ID。 | 1001 |
| └tenantGuid | string | 企业租户 ID。 | tenant_abc |
| └spaceId | int64 | 所属空间 ID。 | 123456 |
| └metaName | string | 属性名称。 | 产品线 |
| └agentEnable | int32 | 是否开启 Agent 引用;1 表示开启,0 表示关闭。 | 1 |
| └creator | string | 创建人账号或 GUID。 | zhangsan |
| └creatorName | string | 创建人姓名。 | 张三 |
| └modifier | string | 最近修改人账号或 GUID。 | lisi |
| └modifierName | string | 最近修改人姓名。 | 李四 |
| └scopeVO | object | 属性引用范围。 | |
| └allTag | int32 | 是否适用于全部目录;1 表示全部目录,0 表示指定范围。 | 1 |
| └metaType | int32 | 属性数据类型;1 表示文本,2 表示标签。 | 2 |
| └defaultTag | int32 | 是否预制属性;0 表示否,1 表示是。 | 0 |
| └dbUpdateTime | date-time | 更新时间。 | 2026-06-12T10:00:00+08:00 |
| └dbCreateTime | date-time | 创建时间。 | 2026-06-12T09:00:00+08:00 |
错误码
| 状态码 | 描述 |
|---|---|
| 400 | 请求参数错误。常见业务码:402 MISS_PARAM、403 ERR_PARAM。 |
| 401 | OPENAPI_AUTH 鉴权失败。常见业务码:405 AUTH_FAILED。 |
| 404 | 资源不存在。常见业务码:404 NOT_FOUND、408 SPACE_NOT_EXISTS。 |
| 500 | 服务内部异常。常见业务码:500 ERROR。 |
postEndpoint
/api/athena/openApi/external/spaceMetaListcurl -X POST "https://b.163.com/api/athena/openApi/external/spaceMetaList" \ -H "Content-Type: application/json" \ -d '{ "spaceId": 123456 }'{
"code": 200,
"msg": "ok",
"message": "string",
"data": [
{
"id": 1001,
"tenantGuid": "tenant_abc",
"spaceId": 123456,
"metaName": "产品线",
"agentEnable": 1,
"creator": "zhangsan",
"creatorName": "张三",
"modifier": "lisi",
"modifierName": "李四",
"scopeVO": {
"allTag": 1
},
"metaType": 2,
"defaultTag": 0,
"dbUpdateTime": "2026-06-12T10:00:00+08:00",
"dbCreateTime": "2026-06-12T09:00:00+08:00"
}
]
}{
"code": 200,
"msg": "ok",
"message": "string"
}{
"code": 200,
"msg": "ok",
"message": "string"
}{
"code": 200,
"msg": "ok",
"message": "string"
}{
"code": 200,
"msg": "ok",
"message": "string"
}这篇文档有帮助吗?