获取节点新版SDK
更新于 2023-06-06
接口功能介绍
调用本接口,根据操作者unionId和节点id,获取单个节点信息。示例如下:

权限
要调用此API,需要以下权限之一。
应用类型 | 是否支持 | 权限 | API Explorer调试 |
---|---|---|---|
企业内部应用 | 支持 | 知识库节点读权限 | API Explorer |
第三方企业应用 | 支持 | 知识库节点读权限 | API Explorer |
第三方个人应用 | 暂不支持 | 知识库节点读权限 | 暂不支持 |
请求方法
Header参数
名称 | 类型 | 是否必填 | 描述 |
---|---|---|---|
x-acs-dingtalk-access-token | String | 是 | 调用该接口的访问凭证。
|
Path参数
Query参数
名称 | 类型 | 是否必填 | 描述 |
---|---|---|---|
withStatisticalInfo | Boolean | 否 | 是否获取统计信息:
说明
默认值false。 |
withPermissionRole | Boolean | 否 | 是否获取权限信息:
说明
默认值false。 |
operatorId | String | 是 | 操作人unionId。 |
返回参数
名称 | 类型 | 描述 |
---|---|---|
node | Object | 节点。 |
nodeId | String | 节点id(dentryUuid)。 |
workspaceId | String | 知识库id(spaceUuid)。 |
name | String | 名称。 |
size | Long | 大小。 |
type | String | 类型,枚举值:
|
category | String | 类别,枚举值:
|
extension | String | 后缀。 |
url | String | 访问url。 |
creatorId | String | 创建者userId。 |
modifierId | String | 修改者userId。 |
createTime | String | 创建时间。 |
modifiedTime | String | 修改时间。 |
hasChildren | Boolean | 是否有子节点。 |
statisticalInfo | Object | 统计信息。 |
wordCount | Long | 字数。 |
permissionRole | String | 当前用户对知识库节点的权限角色,枚举值:
|
示例
请求示例
返回示例
错误码
HttpCode | 错误码 | 错误信息 | 说明 |
---|---|---|---|
400 | paramError | %s | 参数错误 |
403 | permissionDenied | %s | 当前用户无此操作权限 |
404 | nodeNotExist | %s | 节点不存在 |
500 | systemError | %s | 服务繁忙,请稍后重试 |
500 | unknownError | Unknown Error | 未知错误 |
503 | operationTimeout | %s | 请求超时 |