证件照回执检测+制作

接口地址:https://api.zheyings.cn/receipt/make

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

返回格式:json

接口费用:调用免费

请求参数:

名称 必填 类型 说明
key string 应用的key
item_id int 规格id,《查看回执规格列表》
image string base64后的图片内容

返回参数:

名称 类型 说明
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"
}

证件照回执提交

接口地址:https://api.zheyings.cn/receipt/submit

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

返回格式:json

接口费用:订单办理完成扣费,价格查看规格列表单价栏

请求参数:

名称 必填 类型 说明
key string 应用的key
pic_id int 制作接口返回的pic_id,有效期50分钟。
notice_url string 回调地址
param string 附加参数(json),具体查看每个规格的要求,如下广东驾驶证:
{"text_mobile":"13800138000","text_city":"深圳","text_name":"姓名","text_idcard":"身份证号码"}

返回参数:

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

JSON返回示例:

{
    "data": {
        "order_no": "20210616134106190536"
    },
    "code": 0,
    "msg": "提交成功"
}

订单状态通知

订单开始审核,不合格驳回,订单完成,会以post方式向商家“回调地址(notice_url)”发送通知。

通知字段:

名称 固定字段 类型 说明
status int 订单状态:2=审核中,3=办理完成,-1=审核失败,-2=取消完成。
order_no string 订单号
sign string 当前应用的“apikey”md5后的结果,用此字段校验数据安全
image_receipt string 回执照地址,订单完成(status=3)返回
image string 证件照地址,订单完成(status=3)返回,仅在证件照有调整时返回
image_print string 排版照地址,订单完成(status=3)返回,支持规格:广东驾驶证,港澳通行证
reject_msg string 审核驳回理由,审核失败(status=-1)返回

商家响应返回示例(JSON):

商家接收并处理通知数据后;需要返回一条json告诉平台当前订单状态同步完成。

{
    "data": {},
    "code": 0,
    "msg": "同步完成"
}

订单审核驳回,再次提交

接口地址:https://api.zheyings.cn/receipt/submit

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

返回格式:json

接口费用:订单办理完成扣费,价格查看规格列表单价栏

请求参数:

名称 必填 类型 说明
key string 应用的key
pic_id int 制作接口返回的pic_id,有效期50分钟。
order_no int 上次提交的订单号
notice_url string 回调地址
param string 附加参数(json),具体查看每个规格的要求,如下广东驾驶证:
{"text_mobile":"13800138000","text_city":"深圳","image_idcard":"iVBORw0KGgoiVBORw0KGgo...."}

返回参数:

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

JSON返回示例:

{
    "data": {
        "order_no": "20210616134106190536"
    },
    "code": 0,
    "msg": "提交成功"
}

订单取消

接口地址:https://api.zheyings.cn/receipt/cancel

接口说明:订单待处理的状态下才可以取消

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

返回格式:json

请求参数:

名称 必填 类型 说明
key string 应用的key
order_no int 上次提交的订单号

返回参数:

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

JSON返回示例:

{
    "data": {},
    "code": 0,
    "msg": "取消成功"
}