文档中心 > API类目 > 钉钉API

dingtalk.oapi.smartdevice.facelevel.get (查询人脸实人认证的结果)

查询人脸实人认证的结果

公共参数

环境	HTTP请求地址	HTTPS请求地址
正式环境	http://gw.api.taobao.com/router/rest	https://eco.taobao.com/router/rest

名称	类型	是否必须	描述
access_token	String	是	钉钉提供的授权Token，想了解详情，ISV开发者请点击这里，企业开发者请点击这里。若有疑问，咨询邮箱dingding_open_dingtalk#list.alibaba-inc.com。

请求参数

名称	类型	是否必须	示例值	更多限制	描述
userid_list	String []	必须	123456,abcid	最大列表长度：100	字符串数组

响应参数

名称	类型	示例值	描述
errcode	Number	0	错误码
errmsg	String	成功	错误信息
result	FaceResultVo []	FaceResultVo	父对象
└ certify_type Number 3 实人认证结果 1:已实名 3:已实人 4:管理员通过 └ has_face Boolean true 有人脸 └ last_modified Date 2020-04-14 15:00:00 人脸最后更新时间 └ userid String 6090158666 用户staffid └ operator_userid String manager 当前操作人的userid └ operator_username String 张三丰当前操作人的姓名 └ certify_name String 张无忌员工认证姓名

请求示例

JAVA
.NET
PHP
CURL
Python
C/C++
NodeJS

DingTalkClient client = new DefaultDingTalkClient("https://oapi.dingtalk.com/topapi/smartdevice/facelevel/get");
OapiSmartdeviceFacelevelGetRequest req = new OapiSmartdeviceFacelevelGetRequest();
req.setUseridList("123456,abcid");
OapiSmartdeviceFacelevelGetResponse rsp = client.execute(req, access_token);
System.out.println(rsp.getBody());

响应示例

JSON示例

{
    "errcode":0,
    "errmsg":"成功",
    "result":[
        {
                "certify_type":3,
                "has_face":true,
                "last_modified":"2020-04-14 15:00:00",
                "userid":"6090158666",
                "operator_userid":"manager",
                "operator_username":"张三丰",
                "certify_name":"张无忌"
        }
    ]
}

异常示例

JSON示例

{
    "errcode":88,
    "errmsg":"ding talk error"
}

错误码解释

错误码	错误描述	解决方案

API工具

API测试工具错误码查询工具 SDK下载

如何获得此API

FAQ

我要提问

返回
顶部

开放平台

钉钉API

dingtalk.oapi.smartdevice.facelevel.get (查询人脸实人认证的结果)

公共参数

请求参数

响应参数

请求示例

响应示例

异常示例

错误码解释

API工具

如何获得此API

FAQ