搜索结果

×

搜索结果将在这里显示。

图片上传

接口描述:代理商可通过该接口上传图片,获取进件所需图片文件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());
}