获取节点

GET

/v2.0/wiki/nodes/{nodeId}

接口调用量说明钉钉标准版接口累计可调用次数为1万次/月，当前接口会消耗调用次数。若该调用量无法满足需求，你可升级钉钉专业版(Open API调用量50万次/月)或钉钉专属版(Open API调用量500万次/月)扩容调用次数。

获取节点。

接口功能介绍

调用本接口，根据操作者unionId和节点id，获取单个节点信息。示例如下：

权限

要调用此API，需要以下权限之一。

应用类型	是否支持	权限	API Explorer调试
企业内部应用	支持	知识库节点读权限	API Explorer
第三方企业应用	支持	知识库节点读权限	API Explorer
第三方个人应用	暂不支持	知识库节点读权限	暂不支持

错误码

HttpCode	错误码	错误信息	说明
400	paramError	%s	参数错误
403	permissionDenied	%s	当前用户无此操作权限
404	nodeNotExist	%s	节点不存在
500	systemError	%s	服务繁忙，请稍后重试
500	unknownError	Unknown Error	未知错误
503	operationTimeout	%s	请求超时

请求示例

Shell

JavaScript

Java

Swift

curl --location --request GET 'https://api.dingtalk.com/v2.0/wiki/nodes/?withStatisticalInfo=Boolean&withPermissionRole=Boolean&operatorId=String'

响应示例

{
  "node": {
    "nodeId": "string",
    "workspaceId": "string",
    "name": "string",
    "size": 0,
    "type": "string",
    "category": "string",
    "extension": "string",
    "url": "string",
    "creatorId": "string",
    "modifierId": "string",
    "createTime": "string",
    "modifiedTime": "string",
    "hasChildren": true,
    "statisticalInfo": {
      "wordCount": 0
    },
    "permissionRole": "string"
  }
}

请求参数

Path 参数

nodeId

string

必需

节点id(节点dentryUuid)：

企业内部应用，可通过调用获取知识库列表接口，获取返回参数rootNodeId字段。

第三方企业应用，可通过调用获取知识库列表接口，获取返回参数rootNodeId字段。

Query 参数

withStatisticalInfo

string

可选

是否获取统计信息：

true：获取
false：不获取
说明
默认值false。

示例值:

Boolean

withPermissionRole

string

可选

是否获取权限信息：

true：获取
false：不获取
说明
默认值false。

示例值:

Boolean

operatorId

string

必需

操作人unionId。

示例值:

String

返回响应

🟢200成功

application/json

Body

node

object

节点。

必需

nodeId

string

必需

节点id(dentryUuid)。

workspaceId

string

必需

知识库id(spaceUuid)。

name

string

名称。

必需

size

integer

大小。

必需

type

string

必需

类型，枚举值： FILE：文件 FOLDER：文件夹

获取节点

接口功能介绍#

权限#

错误码#

请求参数

返回响应

接口功能介绍

权限

错误码