办签材料上传
商家在变更状态:“8-已收到签证结果”与“9-已预约(需采集指纹/面试签)”之前,如果有签证材料 ,需要完成对应状态变更时签证材料文件的上传,商家上传文件之后,马蜂窝将向用户返回:file_unique_key字段,作为后续状态变更时的材料信息唯一标识
注意:
1. 此接口上传文件时需要 HTTP 请求的 Header 的content-type :multipart/form-data 格式。
2. 通用的接口请求参数是{partnerId ,action,timestamp,nonce,data,sign,access_token } 而 这个文件接口上传需要在以上基础上再传递一个参数file_data ,用来发送文件内容。
3. 此接口只支持 'jpg','jpeg','gif','png','pdf'格式文件上传,且上传文件大小不得超过5M。
请求URL
正式环境:https://openapi.mafengwo.cn/deals/rest
请求Action
action:sales.visa.file.upload
请求参数
参数名称 |
参数类型 |
必填 |
示例 |
描述 |
file_name |
string |
是 | a.jpg |
需要上传的材料的文件名 |
响应参数
参数名称 |
参数类型 |
示例 |
描述 |
file_unique_key |
string |
0cdf7857845bce541913ef2d77212963 |
根据上传文件生成的唯一的文件标识 |
响应示例
{
"file_unique_key":"0cdf7857845bce541913ef2d77212963"
}
异常错误码
异常码 |
异常信息 |
10071004 |
上传文件不能大于5M |
10071003 |
文件名格式有误 |
10071002 |
上传文件失败 |
10071001 |
上传文件名称与文件名不符 |