使用证件照api接口快速上线证件照业务-超详细！

公司的新产品需要接入证件照服务，本想用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"
}