一.检测证件照

 

基本信息:

请求类型: HTTP

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

请求方式: POST

数据类型: JSON

响应类型: JSON

接口状态启用

 

接口描述:

检测证件照

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

 

请求参数:

 

参数名称

是否必须

类型

描述

file

true

string

图片的base64数据

spec_id

true

string

已有的规格ID

app_key

true

string

已申请的app_key

 

 

响应数据:

 

参数名称

是否必须

数据类型

示例值

描述

code

true

number

200

状态码

check_result

true

number

1

检测结果汇总,各检测项中有一项未通过则为0,全部通过则为1

result

true

object

 

各个参数的检查结果:1代表通过,0代表未通过

background_color

false

number

1

背景色

clothes_similar

false

number

1

服装相似度

eyes_close

false

number

1

闭眼程度

eyes_nature

false

number

1

视线

eyes_space_bottom

false

number

1

双眼中心距图像下边缘

face_blur

false

number

1

模糊

face_center

false

number

1

脸部居中

face_color

false

number

1

脸部颜色

face_expression

false

number

1

脸部表情

face_noise

false

number

1

脸部噪音

face_unbalance

false

number

1

阴阳脸

facial_pose

false

number

1

脸部姿态

facial_shelter

false

number

1

脸部遮挡

file_size

false

number

1

文件大小

glasses

false

number

1

眼镜样式

glasses_glare

false

number

1

眼镜反光

mouse_nature

false

number

1

嘴巴自然

name

false

string

英语四六级考试

规格名字

photo_format

false

number

1

文件类型

px_and_mm

false

number

1

像素和毫米大小

shoulder_equal

false

number

1

肩膀自然

sight_line

false

number

1

视线水平

spec_id

false

number

23

规格ID

 

 

 

例子:

 

Python  请求演示:

 

import requests
import base64
import json

 

 

url = 'http://apicall.id-photo-verify.com/api/check_pic'
pic = open('test.jpg', 'rb').read()
headers = {
'Content-Type': 'application/json'}
data = {
   
"spec_id": 23,
   
"app_key": 'a2ffc7fd859a1267da524ce6efb58f8bd0b68247',
   
"file": base64.b64encode(pic).decode()}
data_json = json.dumps(data)
response = requests.post(
   
url=url,
   
headers=headers,
   
data=data_json)
print(response.text)
 

 

 

返回数据:

 

{

  "check_result": 0,

  "code": 200,

  "result": {

    "background_color": 1,

    "clothes_similar": 1,

    "face_blur": 1,

    "face_center": 1,

    "face_expression": 1,

    "face_noise": 1,

    "facial_pose": 1,

    "file_size": 0,

    "left_right_empty": 1,

    "name": "\u82f1\u8bed\u56db\u516d\u7ea7\u8003\u8bd5",

    "photo_format": 1,

    "px_and_mm": 0,

    "shoulder_equal": 1,

    "sight_line": 1,

    "spec_id": 23

  }

}

 

 

状态码:

 

状态码

描述

解决方案

200

请求成功

 

400

规格不存在

输入已有规格

401

app_key不存在

输入已申请的正确app_key

412

app类型不正确

输入已申请的对应类型的app_key

417

已达到最大调用次数

购买调用次数

507

输入的图片没有检测到人脸

 

 

 

 

 

二.制作证件照

 

基本信息:

请求类型: HTTP

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

请求方式: POST

数据类型: JSON

响应类型: JSON

接口状态启用

 

接口描述:

制作证件照

调用此接口不会增加已调用次数

结果返回带水印图片,无水印图片和无水印已排版图片名字(均为多种颜色)

通过名字获取带水印图片不会增加已调用次数

获取无水印图片或无水印已排版图片会增加1次调用次数

 

请求参数:

 

参数名称

是否必须

类型

描述

file

true

string

图片的base64数据

spec_id

true

string

已有的规格ID

app_key

true

string

已申请的app_key

 

 

响应数据:

 

参数名称

是否必须

数据类型

示例值

描述

code

true

number

200

状态码

result

true

object

 

 

file_name

true

list

["ba70879a6c5d11e782ad00163e06132a18823blue2",
"ba70879b6c5d11e782ad00163e06132a15277white2",
"ba70879c6c5d11e782ad00163e06132a18828red2",
"ba70879d6c5d11e782ad00163e06132a89092blue22",
"ba70879e6c5d11e782ad00163e06132a78588grey2",
"ba70879f6c5d11e782ad00163e06132a79009blue32"]

无水印图片名字,包括多种可选颜色

size

true

list

[295, 413]

图片尺寸

file_name_wm

true

list

["ba70879a6c5d11e782ad00163e06132ablue2_wm", 
"ba70879b6c5d11e782ad00163e06132awhite2_wm",
"ba70879c6c5d11e782ad00163e06132ared2_wm",
"ba70879d6c5d11e782ad00163e06132ablue22_wm",
"ba70879e6c5d11e782ad00163e06132agrey2_wm",
"ba70879f6c5d11e782ad00163e06132ablue32_wm"]

带水印图片名字,包括多种可选颜色

is_print

true

number

1

有无排版

file_name_print

true

list

["ba70879a6c5d11e782ad00163e06132a18823blue2_print2", 
"ba70879b6c5d11e782ad00163e06132a15277white2_print2", 
"ba70879c6c5d11e782ad00163e06132a18828red2_print2", 
"ba70879d6c5d11e782ad00163e06132a89092blue22_print2", 
"ba70879e6c5d11e782ad00163e06132a78588grey2_print2", 
"ba70879f6c5d11e782ad00163e06132a79009blue32_print2"]

无水印图片名字,包括多种可选颜色

size_print

true

list

[1795, 1205]

排版后图片尺寸

 

 

 

例子:

 

Python  请求演示:

 

import requests
import base64
import json

 

 

url = ' http://apicall.id-photo-verify.com/api/cut_pic'
pic = open('test.jpg', 'rb').read()
headers = {
'Content-Type': 'application/json'}
data = {
   
"spec_id": 360,
   
"app_key": 'a2ffc7fd859a1267da524ce6efb58f8bd0b68247',
   
"file": base64.b64encode(pic).decode()}
data_json = json.dumps(data)
response = requests.post(
   
url=url,
   
headers=headers,
   
data=data_json)
print(response.text)
 

 

 

返回数据:

 

{

  "code": 200,

  "result": {

    "file_name": [

      "ba70879a6c5d11e782ad00163e06132a18823blue2",

      "ba70879b6c5d11e782ad00163e06132a15277white2",

      "ba70879c6c5d11e782ad00163e06132a18828red2",

      "ba70879d6c5d11e782ad00163e06132a89092blue22",

      "ba70879e6c5d11e782ad00163e06132a78588grey2",

      "ba70879f6c5d11e782ad00163e06132a79009blue32"

    ],

    "file_name_print": [

      "ba70879a6c5d11e782ad00163e06132a18823blue2_print2",

      "ba70879b6c5d11e782ad00163e06132a15277white2_print2",

      "ba70879c6c5d11e782ad00163e06132a18828red2_print2",

      "ba70879d6c5d11e782ad00163e06132a89092blue22_print2",

      "ba70879e6c5d11e782ad00163e06132a78588grey2_print2",

      "ba70879f6c5d11e782ad00163e06132a79009blue32_print2"

    ],

    "file_name_wm": [

      "ba70879a6c5d11e782ad00163e06132ablue2_wm",

      "ba70879b6c5d11e782ad00163e06132awhite2_wm",

      "ba70879c6c5d11e782ad00163e06132ared2_wm",

      "ba70879d6c5d11e782ad00163e06132ablue22_wm",

      "ba70879e6c5d11e782ad00163e06132agrey2_wm",

      "ba70879f6c5d11e782ad00163e06132ablue32_wm"

    ],

    "is_print": 1,

    "size": [

      295,

      413

    ],

    "size_print": [

      1795,

      1205

    ]

  }

}

 

 

 

 

状态码:

 

状态码

描述

解决方案

200

请求成功

 

400

规格不存在

输入已有规格

401

app_key不存在

输入已申请的正确app_key

412

app类型不正确

输入已申请的对应类型的app_key

507

输入的图片没有检测到人脸

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

三.检测及制作证件照

 

基本信息:

请求类型: HTTP

接口地址http://apicall.id-photo-verify.com/api/cut_check_pic
请求方式: POST

数据类型: JSON

响应类型: JSON

接口状态启用

 

接口描述:

检测及制作证件照

调用此接口不会增加调用次数

结果返回带水印图片,无水印图片和无水印已排版图片名字(均为多种颜色)

通过名字获取带水印图片不会增加已调用次数

获取无水印图片或无水印已排版图片会增加1次调用次数

(检测的是制作好后的照片)

 

请求参数:

 

参数名称

是否必须

类型

描述

file

true

string

图片的base64数据

spec_id

true

string

已有的规格ID

app_key

true

string

已申请的app_key

 

 

响应数据:

 

参数名称

是否必须

数据类型

示例值

描述

code

true

number

200

状态码

result

true

object

 

 

check

true

object

 

检测结果汇总,各检测项中有一项未通过则为0,全部通过则为1

check_result

true

object

 

各个参数的检查结果:1代表通过,0代表未通过

background_color

false

number

1

背景色

clothes_similar

false

number

1

服装相似度

eyes_close

false

number

1

闭眼程度

eyes_nature

false

number

1

视线

eyes_space_bottom

false

number

1

双眼中心距图像下边缘

face_blur

false

number

1

模糊

face_center

false

number

1

脸部居中

face_color

false

number

1

脸部颜色

face_expression

false

number

1

脸部表情

face_noise

false

number

1

脸部噪音

face_unbalance

false

number

1

阴阳脸

facial_pose

false

number

1

脸部姿态

facial_shelter

false

number

1

脸部遮挡

file_size

false

number

1

文件大小

glasses

false

number

1

眼镜样式

glasses_glare

false

number

1

眼镜反光

mouse_nature

false

number

1

嘴巴自然

name

false

string

英语四六级考试

规格名字

photo_format

false

number

1

文件类型

px_and_mm

false

number

1

像素和毫米大小

shoulder_equal

false

number

1

肩膀自然

sight_line

false

number

1

视线水平

spec_id

false

number

23

规格ID

file_name

true

list

["ba70879a6c5d11e782ad00163e06132a18823blue2",
"ba70879b6c5d11e782ad00163e06132a15277white2",
"ba70879c6c5d11e782ad00163e06132a18828red2",
"ba70879d6c5d11e782ad00163e06132a89092blue22",
"ba70879e6c5d11e782ad00163e06132a78588grey2",
"ba70879f6c5d11e782ad00163e06132a79009blue32"]

无水印图片名字,包括多种可选颜色

size

true

list

[295, 413]

图片尺寸

file_name_wm

true

list

["ba70879a6c5d11e782ad00163e06132ablue2_wm", 
"ba70879b6c5d11e782ad00163e06132awhite2_wm",
"ba70879c6c5d11e782ad00163e06132ared2_wm",
"ba70879d6c5d11e782ad00163e06132ablue22_wm",
"ba70879e6c5d11e782ad00163e06132agrey2_wm",
"ba70879f6c5d11e782ad00163e06132ablue32_wm"]

带水印图片名字,包括多种可选颜色

is_print

true

number

1

有无排版

file_name_print

true

list

["ba70879a6c5d11e782ad00163e06132a18823blue2_print2", 
"ba70879b6c5d11e782ad00163e06132a15277white2_print2", 
"ba70879c6c5d11e782ad00163e06132a18828red2_print2", 
"ba70879d6c5d11e782ad00163e06132a89092blue22_print2", 
"ba70879e6c5d11e782ad00163e06132a78588grey2_print2", 

"ba70879f6c5d11e782ad00163e06132a79009blue32_print2"]

无水印图片名字,包括多种可选颜色

size_print

true

list

[1795, 1205]

排版后图片尺寸

 

 

 

例子:

 

Python  请求演示:

 

import requests
import base64
import json

 

 

url = 'http://apicall.id-photo-verify.com/api/cut_check_pic'
pic = open('test.jpg', 'rb').read()
headers = {
'Content-Type': 'application/json'}
data = {
   
"spec_id": 360,
   
"app_key": 'a2ffc7fd859a1267da524ce6efb58f8bd0b68247',
   
"file": base64.b64encode(pic).decode()}
data_json = json.dumps(data)
response = requests.post(
   
url=url,
   
headers=headers,
   
data=data_json)
print(response.text)
 

 

 

返回数据:

 

{

  "code": 200,

  "result": {

    "check": 1,

    "check_result": {

      "background_color": 1,

      "clothes_similar": 1,

      "face_blur": 1,

      "face_center": 1,

      "face_expression": 1,

      "face_noise": 1,

      "facial_pose": 1,

      "name": "\u7b80\u5386\u7167\u7247\uff08\u4e00\u5bf8\uff09",

      "photo_format": 1,

      "px_and_mm": 1,

      "shoulder_equal": 1,

      "sight_line": 1,

      "spec_id": 360

    },

    "file_name": [

      "9fd7e5266c7211e782ad00163e06132a80779blue3",

      "9fd7e5276c7211e782ad00163e06132a81089white3",

      "9fd7e5286c7211e782ad00163e06132a67368red3",

      "9fd7e5296c7211e782ad00163e06132a99083blue23",

      "9fd7e52a6c7211e782ad00163e06132a46532grey3",

      "9fd7e52b6c7211e782ad00163e06132a06876blue33"

    ],

    "file_name_print": [

      "9fd7e5266c7211e782ad00163e06132a80779blue3_print3",

      "9fd7e5276c7211e782ad00163e06132a81089white3_print3",

      "9fd7e5286c7211e782ad00163e06132a67368red3_print3",

      "9fd7e5296c7211e782ad00163e06132a99083blue23_print3",

      "9fd7e52a6c7211e782ad00163e06132a46532grey3_print3",

      "9fd7e52b6c7211e782ad00163e06132a06876blue33_print3"

    ],

    "file_name_wm": [

      "9fd7e5266c7211e782ad00163e06132ablue3_wm",

      "9fd7e5276c7211e782ad00163e06132awhite3_wm",

      "9fd7e5286c7211e782ad00163e06132ared3_wm",

      "9fd7e5296c7211e782ad00163e06132ablue23_wm",

      "9fd7e52a6c7211e782ad00163e06132agrey3_wm",

      "9fd7e52b6c7211e782ad00163e06132ablue33_wm"

    ],

    "is_print": 1,

    "size": [

      295,

      413

    ],

    "size_print": [

      1795,

      1205

    ]

  }

}

 

 

 

 

状态码:

 

状态码

描述

解决方案

200

请求成功

 

400

规格不存在

输入已有规格

401

app_key不存在

输入已申请的正确app_key

412

app类型不正确

输入已申请的对应类型的app_key

417

已达到最大调用次数

购买调用次数

507

输入的图片没有检测到人脸

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

四.获取带水印图片

 

基本信息:

请求类型: HTTP

接口地址http://apicall.id-photo-verify.com/api/take_pic_wm/<file_name>

请求方式: GET

响应类型: Image

接口状态启用

 

接口描述:

获取带水印图片

调用此接口不会增加已调用次数

 

例子:

 

Python  请求演示:

 

from PIL import Image
import requests
import urllib
import io


url =
'http://apicall.id-photo-verify.com/api/take_pic_wm/9fd7e5266c7211e782ad00163e06132ablue3_wm'
file = io.BytesIO(urllib.request.urlopen(url).read())
img = Image.open(file)
img.show()

 

 

 

 

 

 

 

 

 

 

返回数据:

 

 

状态码:

 

状态码

描述

解决方案

404

未找到文件

输入正确的文件名

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

五.获取无水印图片

 

基本信息:

请求类型: HTTP

接口地址http://apicall.id-photo-verify.com/api/take_cut_pic
请求方式: POST

数据类型: JSON

响应类型: Image

接口状态启用

 

接口描述:

获取无水印图片

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

 

请求参数:

 

参数名称

是否必须

类型

描述

file_name

true

string

需要获取图片的名字

app_key

true

string

已申请的app_key

 

例子:

 

Python  请求演示:


import requests
import urllib
import io


url =
'http://apicall.id-photo-verify.com/api/take_cut_pic'
headers = {'Content-Type': 'application/json'}
data = {
   
"file_name": '9fd7e5266c7211e782ad00163e06132a80779blue3',
   
"app_key": 'a2ffc7fd859a1267da524ce6efb58f8bd0b68247',}
data_json = json.dumps(data)
response = requests.post(
   
url=url,
   
headers=headers,
   
data=data_json)
print(response.status_code)

 

 

 

 

 

状态码:

 

状态码

描述

解决方案

404

未找到文件

输入正确的文件名

401

app_key不存在

输入已申请的正确app_key

412

app类型不正确

输入已申请的对应类型的app_key

417

已达到最大调用次数

购买调用次数

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

六.证件照环境检测

 

基本信息:

请求类型: HTTP

接口地址http://apicall.id-photo-verify.com/api/env_pic
请求方式: POST

数据类型: JSON

响应类型: JSON

接口状态启用

 

接口描述:

证件照环境检测

调用此接口不会增加已调用次数

 

请求参数:

 

本接口环境检测采用设定阈值的方式,通过参数传过来的阈值,与算法检测出来的各项对应值比较,得到通过与否的结果(共7个检测项)。设定的阈值越大检测越不严格,越容易通过;阈值越小检测越严格,越不容易通过。

比如facepose检测项用户传过来阈值为20,检测结果为30,则该检测项不通过,如果想要放宽facepose此检测项的要求,可以调整阈值,将上传的阈值改为40,则此检测项即为通过(用户看不到算法检测出来的各项对应值)。

用户可以根据自己需求不断调整传送的阈值,建议阈值依次顺序为40,40,35,2050,50,60

参数名称

是否必须

类型

描述

file

true

string

图片的base64数据

app_key

true

string

已申请的app_key

facepose

true

string/ number

人脸是正对镜头(姿态阈值

eyegaze

true

string/ number

视线是否正常  阈值

eyeskew

true

string/ number

眼睛是否歪斜(双眼连线不水平阈值

shoulderskew

true

string/ number

肩膀是否水平正对镜头  阈值

darkillum

true

string/ number

照片光照是否昏暗  阈值

unbalanceillum

true

string/ number

人脸是否为阴阳脸  阈值

bfsimilarity

true

string/ number

衣服和背景颜色是否相似  阈值

 

 

响应数据:

 

参数名称

数据类型

示例值

描述

code

number

200

状态码

msg

number

SUCCESS

接口调用信息

total_result

number

1

检测结果汇总,各检测项中有一项未通过则为0,全部通过则为1

result

object

 

各个参数的检查结果:1代表通过,0代表未通过

facepose

number

1

人脸是正对镜头(姿态)

eyegaze

number

1

视线是否正常

eyeskew

number

1

眼睛是否歪斜(双眼连线不水平)

shoulderskew

number

1

肩膀是否水平正对镜头

darkillum

number

1

照片光照是否昏暗

unbalanceillum

number

1

人脸是否为阴阳脸

bfsimilarity

number

1

衣服和背景颜色是否相似

 

 

例子:

 

Python  请求演示:


import requests
import urllib
import json


url =
'http://apicall.id-photo-verify.com/api/env_pic'
with open('test.jpg', 'rb') as f:
    pic = f.read()
headers = {
'Content-Type': 'application/json'}
data = {

   
"app_key": '改为已申请的对应类型的app_key',
   
"file": base64.b64encode(pic).decode(),
   
'facepose': '40',   # 下列项可以改为需要的阈值
    'eyegaze': '40',
   
'eyeskew': '35',
   
'shoulderskew': '20',
   
'darkillum': '50',
   
'unbalanceillum': '50',
   
'bfsimilarity': '60',
}
data_json = json.dumps(data)
response = requests.post(
   
url=url,
   
headers=headers,
   
data=data_json)
print(response.text)
 

 

 

返回数据:

 

{

  "code": 200,

  "msg": "SUCCESS",

  "result": {

    "bfsimilarity": 1,

    "darkillum": 1,

    "eyegaze": 1,

    "eyeskew": 1,

    "facepose": 1,

    "shoulderskew": 1,

    "unbalanceillum": 1

  },

  "total_result": 1

}

 

 

 

状态码:

 

状态码

描述

解决方案

200

请求成功

 

401

app_key不存在

输入已申请的正确app_key

412

app类型不正确

输入已申请的对应类型的app_key

11000

没有检测到人脸

 

11001

检测到多于一张脸

 

11002

人脸不完整