查询可信设备详细信息
POST
/v1.0/exclusive/trustedDevices/query最后修改时间:: 2 年前
责任人: 未设置
说明
调用本接口查询组织内员工的可信设备详细信息。
服务地址:api.dingtalk.com
权限
要调用此API,需要以下权限之一。
应用类型 | 是否支持 | 权限 | API Explorer调试 |
---|---|---|---|
企业内部应用 | 支持 | 专属钉钉可信设备信息读写权限 | API Explorer |
第三方企业应用 | 暂不支持 | 专属钉钉可信设备信息读写权限 | 暂不支持 |
第三方个人应用 | 暂不支持 | 专属钉钉可信设备信息读写权限 | 暂不支持 |
错误码
HttpCode | 错误码 | 错误信息 | 说明 |
---|---|---|---|
400 | staff.not.found | userId错误 | userId错误 |
400 | param.illegal | 参数不合法 | 参数不合法 |
500 | service.error | 系统错误 | 系统错误 |
请求参数
Header 参数
x-acs-dingtalk-access-token
string
必需
调用该接口的访问凭证。如何获取不同应用的凭证请参考访问凭证概述。
Body 参数application/json
userIds
array[string]
必需
用户userid列表。
示例
{}
示例代码
返回响应
成功(200)
HTTP 状态码: 200
内容格式: JSONapplication/json
数据结构
data
array [object {5}]
查询结果。
userId
string
员工userid。
platform
string
可选
平台类型,目前仅支持Mac和Win两种类型。
macAddress
string
可选
可信设备mac地址。
status
integer
设备状态,取值:
createTime
integer
创建时间,时间戳。
示例
{
"data": [
{
"userId": "string",
"platform": "string",
"macAddress": "string",
"status": 0,
"createTime": 0
}
]
}
最后修改时间: 2 年前