检测证件照

基本信息

请求类型: HTTP/HTTPS

接口地址: http://apicall.id-photo-verify.com/api/check_pic

请求方式: POST

数据类型: JSON

响应类型: JSON

接口状态: 启用

接口描述:

检测证件照是否合格

调用此接口增加 1 次已调用次数

官网上对应的app_key应用类型必须为证件照检测

请求参数

参数名称 是否必须 类型 描述
file str 图片的base64数据(注意不包含base64的头部数据),或者图片在oss的key(见第十三个接口)
app_key str 已申请的app_key
spec_id int 已有的规格ID

响应参数

注:随着传入的spec_id的不同,响应数据的种类会有一些变化
参数名称 类型 示例 描述
code number 200 状态码
check_result number 1 检测结果汇总,各检测项中有一项未通过则为0,全部通过则为1
all_check_result obj {...} 各检测项详细数值
result object   各个参数的检查结果:1代表通过,0代表未通过
background_color number 1 背景色
bg_shadow number 1 背景阴影
chin_bottom number 1 下巴距图像下边缘
clothes_similar number 1 服装相似度
eye_space number 1 眼部距离
eyes_center_left number 1 双眼中心距图像左边缘
eyes_close number 1 闭眼程度
eyes_nature number 1 视线
eyes_space_bottom number 1 双眼中心距图像下边缘
face_blur number 1 模糊
face_center number 1 脸部居中
face_color number 1 脸部颜色(已弃用)
face_expression number 1 脸部表情
face_noise number 1 脸部噪音
face_unbalance number 1 阴阳脸
facial_pose number 1 脸部姿态
facial_shelter number 1 脸部遮挡
facial_width number 1 脸部宽度
file_size number 1 文件大小
glasses number 1 眼镜样式
glasses_glare number 1 眼镜反光
hairline_top number 1 头顶发际线
head_length number 1 头部长度
head_occupy number 1 头部占比
left_right_empty number 1 左右是否各空
mouse_nature number 1 嘴巴自然
name string 英语四六级考试 规格名字
photo_format number 1 文件类型
ppi number 1 检测ppi
px_and_mm number 1 像素和毫米大小
shoulder_equal number 1 肩膀自然
sight_line number 1 视线水平
pn_neck_shadow_exist number 1 脖子阴影
spec_id number 23 规格ID

python请求示例

import requests, json, base64
​
url = "http://apicall.id-photo-verify.com/api/check_pic"
​
with open("test.png", 'rb') as f:
	pic = f.read()
​
headers = {"Content-Type": "application/json"}
​
data = {
	"spec_id": 391,
	"app_key": "您申请的app_key",
	"file": base64.b64encode(pic).decode()
}
data_json = json.dumps(data)
response = requests.post(url, headers=headers, data=data_json)
print(response.text)
							

响应示例

{
  "check_result": 0, 
  "code": 200, 
  "result": {
	"background_color": 0, 
	"clothes_similar": 1, 
	"eyes_close": 1, 
	"face_blur": 1, 
	"face_center": 1, 
	"face_noise": 1, 
	"facial_pose": 1, 
	"headpose_pitch": 1, 
	"headpose_roll": 1, 
	"headpose_yaw": 1, 
	"name": "简历照片(一寸)", 
	"photo_format": 0, 
	"px_and_mm": 0, 
	"shoulder_equal": 1, 
	"sight_line": 1, 
	"spec_id": 391
  }
}