基础 qianmi.cloudshop.item.brand.update(更新商家自定义品牌)

更新商家自定义品牌
 用户授权类型
 公共参数
请求地址:
环境 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分钟
 业务参数
名称 类型 是否必须 示例值 默认值 描述
brand_idString 必须 24351 品牌编号
brand_nameString 可选 Apple 品牌名称
fieldsField List 可选 brand_id,brand_name 新增品牌的信息,返回字段参照ItemBrand结构,多个字段用”,”分隔;
brand_descString 可选 全球手机第一 品牌描述
logoString 可选 jpg@/9j/4AAQSkMEQ8SEhEP..... 品牌图片,最大:1M ,支持的文件类型:gif,jpg,jpeg,png;注:使用BASE64将图片文件进行编码,得到字符串,然后用“@”字符连接字符串(例:contentStr)和图片文件的格式

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

positionString 可选 1 排序
 请求示例
OpenClient client = new DefaultOpenClient(url, appKey, appSecret);
ItemBrandUpdateRequest req = new ItemBrandUpdateRequest();
req.setBrandId("6943");
req.setBrandName("Apple");
req.setFields("position,brand_name");
req.setBrandDesc("手机第一品牌");
req.setLogo("jpgjpg@/9j/4AAQSkMEQ8SEhEP.....	");
req.setPosition("2");
ItemBrandUpdateResponse response = client.execute(req, accessToken);
$client = new OpenClient;
$client->appKey = appKey;
$client->appSecret = appSecret;
$req = new ItemBrandUpdateRequest;
$req->setBrandId("6943");
$req->setBrandName("Apple");
$req->setFields("position,brand_name");
$req->setBrandDesc("手机第一品牌");
$req->setLogo("jpgjpg@/9j/4AAQSkMEQ8SEhEP.....	");
$req->setPosition("2");
$res = $client->execute($req, $accessToken);
IOpenClient client = new DefaultOpenClient(url, appKey, appSecret);
ItemBrandUpdateRequest req = new ItemBrandUpdateRequest();
req.BrandId = "6943";
req.BrandName = "Apple";
req.Fields = "position,brand_name";
req.BrandDesc = "手机第一品牌";
req.Logo = "jpgjpg@/9j/4AAQSkMEQ8SEhEP.....	";
req.Position = "2";
ItemBrandUpdateResponse response = client.Execute(req, accessToken);
 响应参数
名称 类型 示例值 描述
item_brand ItemBrand 具体的字段根据请求中设定的fileds决定
 响应示例

JSON数据格式:

 异常示例

JSON数据格式:

 {
    "errorToken": "@@$-ERROR_TOKEN$-@@",
    "code": "33",
    "message": "非法的参数",
    "solution": "请查看根据服务接口对参数格式的要求",
    "subErrors": {
      "subError": [{
          "code": "isv.invalid-paramete:XXXX",
          "message": "参数XXXX无效,格式不对、非法值、越界等"
        }]
  }
 错误码
错误码 错误描述 解决方案
isv.qianmi-cloudshop-item-brand-update-service-error:01030028=logo图片上传失败检查图片大小与格式是否正确
isv.qianmi-cloudshop-item-brand-update-service-error:01030029logo图片大小超过1M检查图片大小是否超过1M
isv.qianmi-cloudshop-item-brand-update-service-error:01030042logo图片格式错误检查图片格式是否正确
isv.qianmi-cloudshop-item-brand-update-service-error:01030053=所上传图片为非图片文件检查所上传图片格式是否正确
isv.qianmi-cloudshop-item-brand-update-service-error:01030055品牌描述不可有特殊字符,且长度不可超过999个字符检查品牌描述是否有特殊字符、长度是否超过999个字符
isv.qianmi-cloudshop-item-brand-update-service-error:01030054修改品牌时,品牌排序、品牌名称、品牌描述、品牌logo不可同时为空检查参数排序、品牌名称、品牌描述、品牌logo是否同时为空
isv.qianmi-cloudshop-item-brand-update-service-error:01030013品牌不存在适用正确的品牌编号
isv.qianmi-cloudshop-item-brand-update-service-error:01030056品牌名称已存在检查品牌名称是否已经存在
 FAQ