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

dingtalk.oapi.edu.face.search (家校人脸识别接口)

家校人脸识别接口

公共参数

环境	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。

请求参数

名称	类型	是否必须	示例值	更多限制	描述
class_id	Number	必须	1001		班级id
url	String	必须	图片url		https://img.alicdn.com/tfs/TB1._LRfUz1gK0jSZLeXXb9kVXa-36-32.png
width	Number	可选	200		图片宽度，同步调用时候必须
height	Number	可选	110		图片宽度，同步调用时候必须
userid	String	可选	09888765		用户id
synchronous	Boolean	可选	false	默认值：false	是否同步调用，默认不同步

响应参数

名称	类型	示例值	描述
result	TopSubmitFaceSearchResponse	response	response
faces Faces [] list 人脸列表 └ score String 0.998 人脸相似度 └ tag_id String 12 标签id └ face_type String RECORD 来自录入还是标记 └ userid String 098765220 用户id └ task_id String BA882 任务id
success	Boolean	true	是否调用成功
errcode	Number	-1	系统错误
errmsg	String	REMOTE ERROR	错误信息

请求示例

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

DingTalkClient client = new DefaultDingTalkClient("https://oapi.dingtalk.com/topapi/edu/face/search");
OapiEduFaceSearchRequest req = new OapiEduFaceSearchRequest();
req.setClassId(1001L);
req.setUrl("图片url");
req.setWidth(200L);
req.setHeight(110L);
req.setUserid("09888765");
req.setSynchronous(false);
OapiEduFaceSearchResponse rsp = client.execute(req, access_token);
System.out.println(rsp.getBody());

IDingTalkClient client = new DefaultDingTalkClient("https://oapi.dingtalk.com/topapi/edu/face/search");
OapiEduFaceSearchRequest req = new OapiEduFaceSearchRequest();
req.ClassId = 1001L;
req.Url = "图片url";
req.Width = 200L;
req.Height = 110L;
req.Userid = "09888765";
req.Synchronous = false;
OapiEduFaceSearchResponse rsp = client.Execute(req, access_token);
Console.WriteLine(rsp.Body);

include "TopSdk.php";
date_default_timezone_set('Asia/Shanghai');

$c = new DingTalkClient(DingTalkConstant::$CALL_TYPE_OAPI, DingTalkConstant::$METHOD_POST , DingTalkConstant::$FORMAT_JSON);
$req = new OapiEduFaceSearchRequest;
$req->setClassId("1001");
$req->setUrl("图片url");
$req->setWidth("200");
$req->setHeight("110");
$req->setUserid("09888765");
$req->setSynchronous("false");
$resp = $c->execute($req, $access_token, "https://oapi.dingtalk.com/topapi/edu/face/search");

curl -X POST "https://oapi.dingtalk.com/topapi/edu/face/search" \
-H 'Content-Type:application/x-www-form-urlencoded;charset=utf-8' \
-d 'access_token=78b88823-2f67-4fc6-9e7e-a5aee91522c1' \
-d 'class_id=1001' \
-d 'height=110' \
-d 'synchronous=false' \
-d 'url=%E5%9B%BE%E7%89%87url' \
-d 'userid=09888765' \
-d 'width=200'

# -*- coding: utf-8 -*-
import dingtalk.api

req=dingtalk.api.OapiEduFaceSearchRequest("https://oapi.dingtalk.com/topapi/edu/face/search")

req.class_id=1001
req.url="图片url"
req.width=200
req.height=110
req.userid="09888765"
req.synchronous=false
try:
	resp= req.getResponse(access_token)
	print(resp)
except Exception,e:
	print(e)

pTopRequest pRequest = alloc_top_request();
pTopResponse pResponse = NULL;
pTaobaoClient pClient = alloc_taobao_client(url, appkey, appsecret);
set_api_name(pRequest,"dingtalk.oapi.edu.face.search");
add_param(pRequest,"class_id","1001");
add_param(pRequest,"url","图片url");
add_param(pRequest,"width","200");
add_param(pRequest,"height","110");
add_param(pRequest,"userid","09888765");
add_param(pRequest,"synchronous","false");
pResponse = top_execute(pClient,pRequest,sessionKey);
printf("ret code:%d\n",pResponse->code);
if(pResponse->code == 0){
	pTopResponseIterator ite = init_response_iterator(pResponse);
	pResultItem pResultItem = alloc_result_item();
	while(parseNext(ite, pResultItem) == 0){
		printf("%s:%s\n",pResultItem->key,pResultItem->value);
	}
	destroy_response_iterator(ite);
	destroy_result_item(pResultItem);
}
destroy_top_request(pRequest);
destroy_top_response(pResponse);
destroy_taobao_client(pClient);

TopClient = require('./topClient').TopClient;
var client = new TopClient({
	'appkey': 'appkey',
	'appsecret': 'secret',
	'REST_URL': 'http://gw.api.taobao.com/router/rest'
});

client.execute('dingtalk.oapi.edu.face.search', {
	'class_id':'1001',
	'url':'图片url',
	'width':'200',
	'height':'110',
	'userid':'09888765',
	'synchronous':'false'
}, function(error, response) {
	if (!error) console.log(response);
	else console.log(error);
})

响应示例

JSON示例

{
    "result":{
        "faces":[
            {
                    "score":"0.998",
                    "tag_id":"12",
                    "face_type":"RECORD",
                    "userid":"098765220"
            }
        ],
        "task_id":"BA882"
    },
    "success":true,
    "errcode":-1,
    "errmsg":"REMOTE ERROR"
}

异常示例

JSON示例

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

错误码解释

错误码	错误描述	解决方案

API工具

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

如何获得此API

FAQ

我要提问

返回
顶部

用户反馈

亲，您还没填写反馈内容。

联系方式

亲，电话号码格式不正确。

验证码刷新
亲，验证码错啦！

提交反馈

用户反馈

感谢您的反馈！

用户反馈

网络异常，请重新提交！
重新提交

钉钉API

dingtalk.oapi.edu.face.search (家校人脸识别接口)

公共参数

请求参数

响应参数

请求示例

响应示例

异常示例

错误码解释

API工具

如何获得此API

FAQ

用户导航

用户反馈

用户反馈

用户反馈