基础 qianmi.cloudshop.sku.image.upload(添加/修改SKU图片)

添加一张图片到num_iid和sku_id指定的sku中 ,传入的sku必须属于当前会话的用户 。如果更新图片需要设置img_id,且该img_id的图片必须属于传入的sku;如果上传图片,img_id不需设置。sku图片数量最多5张,每张图片大小不得超过1M,支持文件类型:gif,jpg,jpeg,png;
 用户授权类型
 公共参数
请求地址:
环境 HTTP请求地址 HTTPS请求地址
正式环境 http://gw.api.qianmi.com/api https://api.qianmi.com/api
系统级请求参数:
名称 类型 是否必须 描述
methodString 必须 API接口名称
access_tokenString 可选 用户登录授权以后,QMOP颁发给应用的授权信息,详细介绍请点击这里,当前API的用户授权类型标明:"需要授权",则此参数必传,"不需要授权",则此参数不需要传。
formatString 必须 指定响应格式,目前支持格式为json
appKeyString 必须 分配给应用的AppKey
vString 必须 API协议版本,当前可选值:1.1
signString 必须 API输入参数签名结果
timestampString 必须 请求时间戳,时区为GMT+8(北京时间),格式:"yyyy-MM-dd HH:mm:ss",例如"2012-12-20 10:20:35",开放平台允许客户端请求的最大时间误差为10分钟
 业务参数
名称 类型 是否必须 示例值 默认值 描述
num_iidString 必须 18353 商品编号
sku_idString 必须 g1234 sku编号
fieldsField List 必须 num_iid,position ItemImg结构中的所有字段均可返回,多个字段用”,”分隔
imageString 可选 jpg@/9j/4AAQSkMEQ8SEhEP..... 商品图片,最大:1M ,支持的文件类型:gif,jpg,jpeg,png;注:使用BASE64将图片文件进行编码,得到字符串,然后用“@”字符连接字符串(例:contentStr)和图片文件的格式(例:jpg);示例:“jpg@contentStr”。

注意:图片参数不参与签名计算

img_idString 可选 图片编号
positionNumber 可选 00 图片顺序,默认0;取值范围0-4
 请求示例
OpenClient client = new DefaultOpenClient(url, appKey, appSecret);
SkuImageUploadRequest req = new SkuImageUploadRequest();
req.setNumIid("31224");
req.setSkuId("g4543");
req.setImage("jpg@/9j/4AAQSkMEQ8SEhEP.....");
req.setFields("position");
SkuImageUploadResponse response = client.execute(req, accessToken);
$client = new OpenClient;
$client->appKey = appKey;
$client->appSecret = appSecret;
$req = new SkuImageUploadRequest;
$req->setNumIid("31224");
$req->setSkuId("g4543");
$req->setImage("jpg@/9j/4AAQSkMEQ8SEhEP.....");
$req->setFields("position");
$res = $client->execute($req, $accessToken);
IOpenClient client = new DefaultOpenClient(url, appKey, appSecret);
SkuImageUploadRequest req = new SkuImageUploadRequest();
req.NumIid = "31224";
req.SkuId = "g4543";
req.Image = "jpg@/9j/4AAQSkMEQ8SEhEP.....";
req.Fields = "position";
SkuImageUploadResponse response = client.Execute(req, accessToken);
 响应参数
名称 类型 示例值 描述
sku_img SkuImg sku图片
 响应示例

JSON数据格式:

 异常示例

JSON数据格式:

 {
    "errorToken": "@@$-ERROR_TOKEN$-@@",
    "code": "33",
    "message": "非法的参数",
    "solution": "请查看根据服务接口对参数格式的要求",
    "subErrors": {
      "subError": [{
          "code": "isv.invalid-paramete:XXXX",
          "message": "参数XXXX无效,格式不对、非法值、越界等"
        }]
  }
 错误码
错误码 错误描述 解决方案
isv.qianmi-cloudshop-sku-image-upload-service-error:01030001商品不存在检查系统中是否存在该商品
isv.qianmi-cloudshop-sku-image-upload-service-error:01030028图片上传失败检查图片大小与格式是否正确
isv.qianmi-cloudshop-sku-image-upload-service-error:01030029图片大小超过1M检查图片大小是否超过1M
isv.qianmi-cloudshop-sku-image-upload-service-error:01030042图片格式错误检查图片格式是否正确
isv.qianmi-cloudshop-sku-image-upload-service-error:01030053所上传图片为非图片文件检查所上传图片格式是否正确
isv.qianmi-cloudshop-sku-image-upload-service-error:01030002sku不存在检查系统中是否存在该sku
isv.qianmi-cloudshop-sku-image-upload-service-error:01030043图片顺序超出范围,或者图片数量已满不可新增检查入参的图片顺序是否大于9;检查商品的图片数量是否已经等于10张。
isv.qianmi-cloudshop-sku-image-upload-service-error:01030044图片不存在检查该商品下是否存在该图片
isv.qianmi-cloudshop-sku-image-upload-service-error:01030038新增图片时,图片文件不可为空新增图片时,检查参数中是否有图片文件
isv.qianmi-cloudshop-sku-image-upload-service-error:01030064未开启规格的商品不能添加sku图片
 FAQ