一、指令概述
该指令用于调用钉钉开放平台接口,通过用户 UserId 查询获取用户 UnionId 与姓名。UnionId 是钉钉钉盘相关接口(获取空间列表、文件列表、创建文件夹)的核心唯一标识,是钉钉钉盘自动化流程的关键前置指令。
二、核心参数配置
| 参数名称 | 说明 | 输入格式 / 规则 |
| 凭证 | 钉钉开放平台接口调用凭证(access_token) | 必填;通过「获取开发平台凭证」指令获取 |
| User Id | 钉钉用户 ID | 必填;通过「查询用户 Id」指令,使用姓名关键词查询得到 |
| 输出变量 - 姓名 | 输出用户真实姓名 | 字符串类型 |
| 输出变量 - Union Id | 输出用户唯一 UnionId | 字符串类型,用于钉盘空间查询等后续接口 |
三、典型操作示例
· 凭证:ding_access_token_xxxx
· User Id:m4PgPMMZNiijuStvkgQD2VAiEiE
· 输出:
姓名:张三
Union Id:xxxxxxx
· 执行效果:获取到该用户的唯一 UnionId,用于后续查询钉盘空间。