证件照回执-证件照Api文档 - 证件照制作领先服务平台

证件照回执检测+制作接口地址：https://api.zjzapi.com/receipt/make
请求方式：POST(application/x-www-form-urlencoded)
返回格式：json
接口费用：调用免费

                            请求参数：
                            
                                
                                    名称
                                    必填
                                    类型
                                    说明
                                

                                
                                    key
                                    是
                                    string
                                    应用的key
                                

                                    item_id
                                    是
                                    int
                                    规格id，《查看回执规格列表》
                                

                                    image
                                    是
                                    string
                                    base64后的图片内容，大小不超过5M。
                                

                            
                        

                            返回参数：
                            
                                
                                    名称
                                    类型
                                    说明
                                

                                
                                    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.zjzapi.com/receipt/submit
请求方式：POST(application/x-www-form-urlencoded)
返回格式：json
接口费用：订单办理完成扣费，7元每单；若选择打印邮寄服务再增加7元

                            请求参数：
                            
                                
                                    名称
                                    必填
                                    类型
                                    说明
                                

                                
                                    key
                                    是
                                    string
                                    应用的key
                                

                                    pic_id
                                    是
                                    int
                                    制作接口返回的pic_id，有效期50分钟。
                                

                                    notice_url
                                    是
                                    string
                                    回调地址
                                

                                    param
                                    否
                                    string
                                    附加参数（json），具体查看每个规格的要求，如下广东驾驶证：
                                        {"text_mobile":"13800138000","text_city":"深圳","text_name":"姓名","text_idcard":"身份证号码"}


                                    
                                

                                    is_print
                                    否
                                    int
                                    是否打印邮寄，1=是，0或不传=否
                                

                                    print_param
                                    否
                                    string
                                    选择打印邮寄（is_print=1）此参数必填，附加参数（json）
                                        {"name":"张三","phone":"13800138000","province":"广东","city":"深圳","district":"南山区","address":"xx路xx小区"}

                                    
                                

                            
                        

                            返回参数：
                            
                                
                                    名称
                                    类型
                                    说明
                                

                                
                                    code
                                    int
                                    状态码
                                

                                    msg
                                    string
                                    返回说明
                                

                                    data
                                    array
                                    数据集
                                

                            
                        

                            JSON返回示例：
                            {
    "data": {
        "order_no": "20210616134106190536"
    },
    "code": 0,
    "msg": "提交成功"
}

                        
订单状态通知订单开始审核，不合格驳回，订单完成，会以POST(application/x-www-form-urlencoded)方式向商家“回调地址（notice_url）”发送通知。

                            通知字段：
                            
                                
                                    名称
                                    固定字段
                                    类型
                                    说明
                                

                                
                                        status
                                        是
                                        int
                                        订单状态：2=审核中，3=办理完成，4=打印发货，-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）返回
                                    

                                        logistics_info
                                        否
                                        array
                                        物流信息，打印发货（status=4）返回
                                            {"express_name":"韵达"，"express_no":"1234567890"}

                                        
                                    

                            
                        
商家响应返回示例（JSON）：商家接收并处理通知数据后；需要返回一条json告诉平台当前订单状态同步完成。
{
    "data": {},
    "code": 0,
    "msg": "同步完成"
}
订单审核驳回，再次提交接口地址：https://api.zjzapi.com/receipt/submit
请求方式：POST(application/x-www-form-urlencoded)
返回格式：json
接口费用：订单办理完成扣费，7元每单；若选择打印邮寄服务再增加7元。

                            请求参数：
                            
                                
                                    名称
                                    必填
                                    类型
                                    说明
                                

                                
                                    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.zjzapi.com/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": "取消成功"
}

                        
办理时间说明请求限制 ：
支持图片格式 ：PEG、JPG、PNG
图像大小：不超过5 MB
图像分辨率：小于6000×6000像素
订单处理时间 ：
9:00-18:00，预计15分钟审核完成
名称	必填	类型	说明
key	是	string	应用的key
item_id	是	int	规格id，《查看回执规格列表》
image	是	string	base64后的图片内容，大小不超过5M。
名称	必填	类型	说明
key	是	string	应用的key
pic_id	是	int	制作接口返回的pic_id，有效期50分钟。
notice_url	是	string	回调地址
param	否	string	附加参数（json），具体查看每个规格的要求，如下广东驾驶证： {"text_mobile":"13800138000","text_city":"深圳","text_name":"姓名","text_idcard":"身份证号码"}
is_print	否	int	是否打印邮寄，1=是，0或不传=否
print_param	否	string	选择打印邮寄（is_print=1）此参数必填，附加参数（json） {"name":"张三","phone":"13800138000","province":"广东","city":"深圳","district":"南山区","address":"xx路xx小区"}
名称	固定字段	类型	说明
status	是	int	订单状态：2=审核中，3=办理完成，4=打印发货，-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）返回
logistics_info	否	array	物流信息，打印发货（status=4）返回 {"express_name":"韵达"，"express_no":"1234567890"}