跳到正文

职业形象照检测+制作

按职业形象照规格检测并制作图片,支持返回多个底色的制作结果。

接口地址:https://api.zjzapi.com/idcardv3/all

请求方式:POST(application/x-www-form-urlencoded)

返回格式:json

接口费用:检测并制作成功扣除0.012 元,检测失败扣除0.006 元,若使用"美颜"功能将多扣除0.012元。

请求参数:

名称 必填 类型 说明
key 是 string 应用的key
item_id 是 int 规格id,《查看规格列表》
image 是 string base64后的图片内容,大小不超过8M
colors 否 string 颜色名称,支持:pose_black、pose_blue、pose_darkgray、pose_gray、pose_white,不填写返回所有底色
beauty 否 int 美颜:0=否,1=是,默认为0

返回参数:

名称 类型 说明
code int 状态码
msg string 返回说明
data array 数据集

JSON返回示例:


{
    "data": {
        "pic_id": "9244614",
        "list": {
             "pose_blue": "http://demo.com/pic/20200511/913191c8906ce81a2107d6ff5157c014/white.jpg"
        }
    },
    "code": 0,
    "msg": "success"
}

请求示例代码:

请替换占位值后在服务端运行。图片使用原始 Base64 字符串,由表单编码器处理特殊字符;不要手动重复 URL 编码。HTTP 成功后仍需检查业务 code。 item_id 请从职业形象照规格列表选择。

# Bash / zsh,cURL 7.76+;Windows 可使用 Git Bash 或 WSL。
curl --fail-with-body --max-time 60 --request POST 'https://api.zjzapi.com/idcardv3/all' \
  --header 'Content-Type: application/x-www-form-urlencoded' \
  --data-urlencode 'key=YOUR_APP_KEY' \
  --data-urlencode 'item_id=YOUR_POSE_ITEM_ID' \
  --data-urlencode 'image=BASE64_ENCODED_IMAGE' \
  --data-urlencode 'colors=pose_white'