图片上传
接口描述:代理商可通过该接口上传图片,获取进件所需图片文件ID
接口说明
适用对象:代理商
请求URL:https://pay.yintongzaixian.com/api/mchApplyment/uploadFile
请求方式:POST
请求类型: multipart/form-data
加签验签说明:图片上传没有加签,不需要验签;
“必填”字段取值“Y“:必填;“N”:非必填;“C”代表条件必填;
请求参数:
| 参数名 | 中文名 | 必填 | 类型 | 说明 |
|---|---|---|---|---|
| agentNo | 代理商号 | C | String | 代理商发起时必填,示例值:A3929388111 |
| mchNo | 商户号 | Y | String | 代理商发起固定传入代理商号;若为商户主动发起则传入商户号;示例值:A3929388111 (代理商),示例值:M3929388111(商户号) |
| appId | 应用APPID | Y | String | 代理商发起固定传入代理商号;若为商户主动发起则传入商户应用ID;示例值:A3929388111,示例值:686b6f5b46c83837aebd1db2 |
| file | 图片文件 | C | file | 文件url链接与file文件流不能同时上传;将媒体图片进行二进制转换,得到的媒体图片二进制内容。在请求body中上传此二进制内容。媒体图片只支持JPG、PNG,JPEG格式。文件大小不能超过2M图片文件,file、fileUrl 二选一,若填入fileUrl,则以fileUrl为准(该参数不参与签名) |
| fileUrl | 文件url链接 | C | String | 文件url链接与file文件流不能同时上传;文件支持类型:JPG,BMP,PNG;文件地址需为公网可访问图片地址。单个图片最大支持2M;(参与签名)file、fileUrl 二选一,若填入fileUrl,则以fileUrl为准,示例值:https://baidu.com/111.jpg |
| reqTime | 请求时间 | Y | long | 请求接口时间,13位时间戳;示例值:1622016572190 |
| version | 接口版本 | Y | String | 接口版本号,固定:1.0,示例值:1.0 |
| signType | 签名类型 | Y | String | 签名类型,目前只支持MD5或RSA2方式;示例值:MD5 |
| sign | 签名 | Y | String | 签名值,详见签名算法示例值:C380BEC2BFD727A4B6845133519F3AD6 |
响应参数:
| 参数名 | 中文名 | 参数类型 | 必填 | 说明 |
|---|---|---|---|---|
| msg | 响应描述 | String | Y | SUCCESS |
| code | 响应码 | String | Y | 0 |
| data | 响应结果 | String | C | |
| fileId | 文件ID | String | C | abae6a9a-d584-422d-9fe0-5c1fefa33af5 |
请求示例::
{
"ifCode": "shengpay",
"agentNo": "A1682391658",
"sign": "85CCE9F72617D2DF4C233501FF1BC33A",
"signType": "MD5",
"fileUrl":"https://baidu.com/9dadef7a-2558-4538-917a-bfaf79fb4155.jpg",
"reqTime": "1753755628275",
"version": "1.0"
}
响应示例:
{
"msg": "SUCCESS",
"code": 0,
"data": {
"fileId": "abae6a9a-d584-422d-9fe0-5c1fefa33af5"
},
"sign": "7627E9034C1D2CAE2CC21EC33619F01E"
}
SDK调用示例(Java):
JeepayClient jeepayClient = JeepayClient.getInstance(Jeepay.appId, Jeepay.apiKey, Jeepay.getApiBase());
ApplymentMchUploadImgRequest request = new ApplymentMchUploadImgRequest();
ApplymentMchUploadImgReqModel model = new ApplymentMchUploadImgReqModel();
model.setAgentNo("A1755505181"); // 代理商号
model.setMchNo(Jeepay.mchNo); // 商户号
model.setAppId(jeepayClient.getAppId()); // 应用ID
model.setFileUrl("https://example.com/image.jpg"); // 文件URL
request.setBizModel(model);
try {
ApplymentMchUploadImgResponse response = jeepayClient.execute(request);
_log.info("验签结果:{}", response.checkSign(Jeepay.apiKey));
if (response.isSuccess(Jeepay.apiKey)) {
_log.info("data:{}", response.getData());
} else {
_log.info("请求失败:mchNo={}, msg={}", Jeepay.mchNo, response.getMsg());
}
} catch (JeepayException e) {
_log.error(e.getMessage());
}