公司的新产品需要接入证件照服务,本想用php来实现,无奈php能实现的功能有限,经过一番搜索最终选择了一家性价比很高的证件照接口服务商,无论从证件照质量,响应速度,价格方面都有不错的优势,还支持证件照美颜,证件照换装,图像增强、证件照换底色、证件照排版等技术,可以不限制背景的证件照制作。
1.注册账号
搜索鹧应证件照api,进入官网注册账号
2.添加应用
账号注册好后,在用户中心页面找到应用管理,点击添加应用,添加完成后就能看到调用证件照api的key了。
3.对接接口
3.1 证件照检测+制作
接口地址:https://api.zjzapi.com/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.zjzapi.com/idcardv5/clothes
请求方式:POST(application/x-www-form-urlencoded)
返回格式:json
接口费用:调用免费,可使用接口返回的"pic_id"获取无水印证件照;更换底色、自定义制作现已支持换装。
请求参数:
| 名称 | 必填 | 类型 | 说明 |
|---|---|---|---|
| key | 是 | string | 应用的key |
| pic_id | 是 | string | 制作接口返回的“pic_id” |
| color | 是 | string | 颜色名称 |
| clothes | 是 | 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.zjzapi.com/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" }