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

家校人脸识别接口

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
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());

    响应示例

    • 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

    FAQ

    返回
    顶部