文件上传
服务说明
[!NOTE]
通过此接口将文件上传到君子签，上传成功返回唯一文件key
http请求方式
[!NOTE]
POST multipart/form-data
http请求地址
[!NOTE]
$SERVICE_URL/v2/file/upload #其中$SERVICE_URL为生产或测试的地址
http请求参数
| 参数 | 类型 | 是否必填 | 默认值 | 说明 |
|---|---|---|---|---|
| file | file | * | 需要上传的文件 |
代码实现
JAVA实现
RequestUtils requestUtils=RequestUtils.init(SERVICE_URL,APP_KEY,APP_SECRET);//建议生成为spring bean
//构建请求参数
Map<String,Object> params=new HashMap<>();
params.put("file", new FileBody(new File("/tmp/仲裁申请书.pdf")));
ResultInfo<Void> ri= requestUtils.doPost("/v2/file/upload",params);
PHP实现
//构建请求工具
$requestUtils=new RequestUtils($serviceUrl, $appkey, $appSecret);
//初始化合同参数
$request=array(
"file" => new CURLFile('D:/tmp/仲裁申请书.pdf',null,"仲裁申请书.pdf")
);
//发起请求
$response=$requestUtils->doPost("/v2/file/upload",$request);
http返回参数
[!NOTE]
返回response为application/json的数据，其字段说明如下
| 参数 | 类型 | 是否必返回 | 说明 |
|---|---|---|---|
| success | bool | * | 成功true；异常false |
| msg | string | ? | 异常时，返回异常原因 |
| resultCode | string | * | 成功0，其它参考附录 |
| data | string | ? | 文件唯一key |
[!NOTE]
返回结果，参考：
//正确响应：
{"data":"private/M00/00/54/wKio6l3twAWANheXAABIiGyUgcY87..png","success":true}
//错误响应：
{"msg":"app_secret不可用","resultCode":"HTTP_PARAM_ERROR","success":false}