# 实时推送人脸信息

# 简介

学生通过学校服务大厅内的人脸识别应用，拍照做人脸采集，微校系统获取到图片后会上传至微校服务器，并将图片链接传给第三方平台。

推送的格式和规则见下文，为了接收推送，需要第三方平台提供与之匹配的接口。

人脸识别应用的人脸采集使用了腾讯 AI 人脸检测与分析技术，腾讯人脸识别基于腾讯优图和腾讯 AI Lab 的深度学习算法和海量数据集，对图片和视频源中面部特征进行提取分析。可实现精准的人脸检测和人脸识别，涵盖人脸检测与分析、五官定位、人脸对比与搜索、跨年龄人脸识别等，为安防监控、人脸美化、智能相册分类等应用场景提供有力的技术支持。

# 产品优势

腾讯 AI 人脸检测与分析技术的产品优势：

样本丰富：立足于腾讯社交大数据平台收集的海量训练集，成功标注千万张人脸。
算法领先：基于腾讯优图和 AILab 的深度人脸模型，不断打磨算法，在国际权威评测平台中保持世界领先。
识别率高：对于一般生活场景中的人脸，达到 99%的准确率和 98%的召回率。
跨年龄识别：在保证通用场景识别能力的同时，实现跨年龄算法不断升级。
服务可靠：训练集源于腾讯核心业务，精细标注、多轮迭代，覆盖多种场景，服务更可靠。
动态贴图：实时追踪人脸，实现人脸的动态贴图，让图片和视频变得更有趣

# 说明

第三方平台需要向微校提供接收人脸的接口地址以及应用的appkey和appSecret，微校在后台配置好地址以后微校服务器会将采集到的人脸数据推送到该地址，第三方平台可对接口进行调试

# 请求

下文描述了第三方接口需要接受的请求参数

# 接口申请

申请方式，发送到hongfuhuang@tencent.com进行申请(邮件同时也抄送至lydiaxyang@tencent.com,leowyang@tencent.com,luishhuang@tencent.com)，申请时需要注明申请内容、应用APPKEY、APPSECRET、应用名称、接收人脸推送接口、接收人脸推送接口的测试截图(模拟发送推送、删除事件并且返回正确响应的截图，例如postman调试截图)、及应用使用场景

# 请求方法：

POST(application/json)

注意

微校服务器发出的请求

# 参数说明：

推送人脸消息通知

{
    "cardNumber":"3128606123", 
    "schoolCode":"4144444559", 
    "imageUrl":"www.xxxxx.com", 
    "appKey":"CA1D90CDCA9ACDCA", 
    "timestamp":"1514276659", 
    "nonce":"5K8264ILTKCH16CQ2502SI8ZNMTM67VS", 
    "signature":"A790E009D309C4BD8605810EAF9C44B0",
}

删除人脸消息通知(厂商接到该通知时，须把本地该用户的照片删除)

{
    "event_type":"delete", 
    "cardNumber":"3128606123", 
    "schoolCode":"4144444559", 
    "appKey":"CA1D90CDCA9ACDCA", 
    "timestamp":"1514276659", 
    "nonce":"5K8264ILTKCH16CQ2502SI8ZNMTM67VS", 
    "signature":"A790E009D309C4BD8605810EAF9C44B0",
}

字段名	变量名	必填	示例值	类型	说明
APP_KEY	appKey	是	CA1D90CDCA9ACDCA	String	在微校注册应用后,分配的应用appKey
事件类型	event_type	否	delete	String	事件类型，仅在通知为删除通知时，有该字段返回
时间戳	timestamp	是	1514276659	long	当前unix时间戳（秒）
随机字符串	nonce	是	5K8264ILTKCH16CQ2502SI8ZNMTM67VS	String(32)	32位随机字符串
数字签名	signature	是	A790E009D309C4BD8605810EAF9C44B0	String(32)	以上参数和 appSecret 根据签名算法计算的值. 第三方需要验证签名确认图片由微校提供
图片地址	imageUrl	否	www.xxxxx.com	String	人脸图片链接(5min 有效)，仅在通知为人脸推送通知时，有该字段
学号	cardNumber	是	3128606123	String(32)	学号
学校代码	schoolCode	是	4144444559	String	学校代码

签名方式：见签名算法 (opens new window)。

# 响应说明：

{
   "result":1, 
   "msg":"ok"
}

参数		必填	类型	实例	说明
result		是	Integer	1	响应状态码，1为成功
msg		是	String	ok	响应信息

# 错误时返回：

{
    "result": xxx,
    "msg":"xxx"
}

参数	是否可空	说明
result	非空	返回码（除1以外的错误码）
msg	非空	错误信息

# 错误码

名称	说明
0	失败
-120	参数错误

# 流程图

人脸采集流程图

# 注意事项

如果要是用消息通知，请参考文档发送通知

← 拉取通行记录