跳转至

图片上传接口

请求方式 body 编码 接口地址
POST multipart/form-data UTF-8 集测:https://mchapitest.shengpay.com/pmtmch/media/upload
生产:https://mchapi.shengpay.com/pmtmch/media/upload

请求参数

变量名 类型 必填 示例 描述
file file Y 将媒体图片进行二进制转换,得到的媒体图片二进制内容,在请求body中上传此二进制内容。媒体图片只支持JPG、PNG,JPEG格式,文件大小不能超过2M图片文件
metaData String Y 图片源数据(JSON字符串)
mchId String(10) Y 30057909 接入方商户号
fileName String(32) Y 商户上传的媒体图片的名称,商户自定义,必须以JPG、PNG、JPEG为后缀图片名称
sha256 String(64) Y 文件hash值
nonceStr String(64) Y 随机字符串
signType String(3) Y RSA 签名
sign String(128) Y 签名串

响应参数

变量名 类型 必填 示例值 描述
returnCode String Y SUCCESS 返回码(SUCCESS/FAIL)
returnMsg String N 返回消息(当returnCode为FAIL时使用)
resultCode String Y SUCCESS 业务结果(SUCCESS/FAIL)
errorCode String N 错误代码(当resultCode为FAIL时使用)
errorCodeDes String N 错误描述(当resultCode为FAIL时使用)
mediaId String(64) Y 图片id
nonceStr String Y nGBXiNhZjBaFrMGIJAKJQQpfNiSGVjzy 随机字符串
signType String Y RSA 签名方式
sign String Y 签名

响应示例

1
2
3
4
5
6
7
8
{
    "returnCode": "SUCCESS",
    "resultCode": "SUCCESS",
    "sign": "labhUfRddLx1CE/S7RfmWk3ZMoaqbBhUyvOMFrCn4fyOPV01eTzSkrms0EUzXBy3Q5oOTm/6TTrh2r3AZzk2Rero/bn70b93GDSpfM+3EyHxpWJTWaaALMhLpyxQhDRnmY5I3ZzRt6LwUvcj8VN8fPeSZnhU/dMtZD4/04CoDdw=",
    "signType": "RSA",
    "mediaId": "656894305859879168",
    "nonceStr": "dEgKFLUTfoSfyeTeYUaCNijDVVNJCsjo"
}
Back to top