公司的新产品需要接入证件照服务,本想用php来实现,无奈php能实现的功能有限,经过一番搜索最终选择了一家性价比很高的证件照接口服务商,无论从证件照质量,响应速度,价格方面都有不错的优势,还支持证件照美颜,证件照换装,图像增强、证件照换底色、证件照排版等技术,可以不限制背景的证件照制作。
1.注册账号
进入官网注册账号:https://zjzapi.com/
2.添加应用
账号注册好后,在用户中心页面找到应用管理,点击添加应用,添加完成后就能看到调用证件照api的key了。
3.对接接口
接口详细文档地址:https://zjzapi.com/doc/v5.html
3.1 证件照检测+制作
接口地址:https://api.zheyings.cn/idcardv5/make
请求方式:POST(application/x-www-form-urlencoded)
返回格式:json
接口费用:调用免费,可使用接口返回的"pic_id"获取无水印证件照
请求参数:
名称 | 必填 | 类型 | 说明 |
---|---|---|---|
key | 是 | string | 应用的key |
item_id | 是 | int | 规格id,《查看规格列表》 |
image | 是 | string | base64后的图片内容 |
colors | 否 | string | 颜色名称,支持:blue、white、red、tint、grey、gradient、dark_blue,不填写返回所有底色 |
enhance | 否 | int | 人像增强,默认已支持,不需要可传参数0 |
beauty | 否 | int | 美颜,默认已支持,不需要可传参数0 |
whitening | 否 | int | 美颜-美白等级:0-100,默认值50,beauty字段必须设置为1,该参数才会生效 |
返回参数:
名称 | 类型 | 说明 |
---|---|---|
code | int | 状态码 |
msg | string | 返回说明 |
data | array | 数据集 |
JSON返回示例:
{
"data": {
"pic_id": "9244614",
"list": {
"white": "http://demo.com/pic/20200511/913191c8906ce81a2107d6ff5157c014/white.jpg"
}
},
"code": 0,
"msg": "success"
}
3.2 证件照换装
接口地址:https://api.zheyings.cn/idcardv5/clothes
请求方式:POST(application/x-www-form-urlencoded)
返回格式:json
接口费用:调用免费,可使用接口返回的"pic_id"获取无水印证件照;更换底色、自定义制作现已支持换装。
请求参数:
名称 | 必填 | 类型 | 说明 |
---|---|---|---|
key | 是 | string | 应用的key |
pic_id | 是 | string | 制作接口返回的“pic_id” |
color | 是 | string | 颜色名称 |
colors | 是 | string | 服装key,《查看服装列表》 |
返回参数:
名称 | 类型 | 说明 |
---|---|---|
code | int | 状态码 |
msg | string | 返回说明 |
data | array | 数据集 |
JSON返回示例:
{
"data": {
"pic_id": "9244614",
"pic": "http://demo.com/pic/20200511/913191c8906ce81a2107d6ff5157c014/white.jpg",
"clothes_key": "blue-child_09"
},
"code": 0,
"msg": "success"
}
3.3 获取证件照
接口地址:https://api.zheyings.cn/idcardv5/get
请求方式:POST(application/x-www-form-urlencoded)
返回格式:json
接口费用:获取成功扣除0.6元,重复获取不扣费。
请求参数:
名称 | 必填 | 类型 | 说明 |
---|---|---|---|
key | 是 | string | 应用的key |
pic_id | 是 | string | 制作接口返回的pic_id,有效期50分钟。 |
clothes_key | 否 | string | 换装接口返回的clothes_key,有效期50分钟。 |
返回参数:
名称 | 类型 | 说明 |
---|---|---|
code | int | 状态码 |
msg | string | 返回说明 |
data | array | 数据集 |
JSON返回示例:
{
"data": {
"white": "http://demo.com/pic/20200511/913191c8906ce81a2107d6ff5157c014/white.jpg"
},
"code": 0,
"msg": "success"
}