|
taobao.item.update API功能描述 | |
| 此接口方法用以更新商品信息。目前暂不支持对二手宝贝进行更新。 |
|
taobao.item.update API调用级别 | |
| apiType=3， 部份服务调用，需要签名校验(用户绑定可选)。 |
|
taobao.item.get API调用参数 | |
| 系统级参数 |
| 名称 | 类型 | 是否必须 | 描述 |
| sip_appkey | String | 必须 | ISV应用的appkey为软件互联平台分配给ISV应用的唯一编号。 |
| sip_apiname | String | 必须 | 服务名。 |
| sip_timestamp | String | 必须 | 服务请求时间戳(yyyy-mm-dd hh:mi:ss)。 |
| sip_sign | String | 必须 | 请求签名（包括了对前面三个必选参数和所有业务参数按签名规则做签名） |
| sip_format | String | 可选 | 规定返回值的类型。支持两种格式json与xml。默认为xml数据格式。 |
| sip_sessionid | String | 必须 | 在ISV应用中用户会话唯一标识。 |
| v | String | 必须 | 必须设置到1.0来使用这个版本的API。 |
| 应用级参数 |
| 名称 | 类型 | 是否必须 | 描述 |
| iid | String(32) | 必须 | 商品ID，上传时不需要 |
| title | String(30) | 可选 | 商品标题 |
| cid | String(32) | 可选 | 类目Id |
| props | String | 可选 | 属性和属性值列表，按逗号分隔 |
| desc | String | 可选 | 商品描述，支持HTML |
| num | int | 可选 | 商品数量 |
| valid_thru | int | 可选 | 商品上架期间，按天计算。只允许7天或14天 |
| list_time | Date | 可选 | 商品上架时间 |
| seller_cid | String | 可选 | 店铺类目 |
| location.state | String | 可选 | 商品所在省份 |
| location.city | String | 可选 | 商品所在城市 |
| price | String | 可选 | 商品价格 |
| post_fee | String | 可选 | 平邮费用 |
| express_fee | String | 可选 | 快递费用 |
| ems_fee | String | 可选 | EMS费用 |
| pay_type | String | 可选 | 付款方式： 款到发货/pay_first，货到付款/goods_first，见商品描述/custom |
| has_discount | boolean | 可选 | 是否参与会员折扣 |
| freight_payer | String | 可选 | 谁承担运费：买家承担运费/buyer，卖家承担运费/seller |
| has_invoice | booelan | 可选 | 是否有发票 |
| has_warranty | booelan | 可选 | 是否有保修 |
| has_showcase | booelan | 可选 | 是否有橱窗推荐 |
| increment | String | 可选 | 加价幅度，如果是一口价，不需要指定 |
| auto_repost | boolean | 可选 | 是否到期自动重发 |
| approve_status | String | 可选 | 商品上传后的状态：正常出售/onsale，放入仓库/instock |
|
正常返回格式 | |
| XML数据格式 | JSON数据格式(暂不支持) |
| <?xml version="1.0" encoding="utf-8" ?> <rsp> <item> <iid>33453</iid> <modified>2008-01-25 12:23:24</modified> <item> </rsp> |
{"iid":"33453","modidied":"2008-01-25 12:23:24"} |
| 返回信息 | 返回信息说明 |
| iid | 商品id |
| modified | 修改时间 |
|
异常返回格式 | |
| 系统级异常 |
| XML数据格式 | JSON数据格式(暂不支持) |
| <?xml version="1.0" encoding="utf-8" ?> <error_rsp> <code>error-code</code> <msg>error-message</msg> </error_rsp> |
{"code":"error-code","msg":"error-message"} |
| 错误码 | 错误描述 | 说明 |
| 8 | Call limited | 呼叫受限，目前指对用户隐私数据的请求频率异常。 |
| 9 | Http action not allowed | 该方法不允许使用此Http动作 |
| 10 | Service currently navailable | 服务不可用 |
| 11 | Insufficient ISV permissions | 第三方程序权限不够 |
| 12 | Insufficient user ermissions | 用户权限不够 |
| 21 | Missing Method | 方法丢失 |
| 22 | Invalid Method | 方法无效 |
| 23 | Invalid Format | 响应格式无效 |
| 24 | Missing signature | 签名丢失 |
| 25 | Invalid signature | 签名无效 |
| 26 | Missing session | 会话期识别码丢失 |
| 27 | Invalid session | 会话期识别码无效 |
| 28 | Missing API Key | sip_appkey丢失 |
| 29 | Invalid API Key | sip_appkey无效 |
| 30 | Missing timestamp | 时间戳丢失 |
| 31 | Invalid timestamp | 时间戳无效 |
| 32 | Missing version | 版本丢失 |
| 33 | Invalid version | 版本错误 |
| 40 | Missing required arguments | 参数丢失，指除
sip_apiname,sip_appkey,sip_sign,sip_timestamp，sip_sessionid,sip_format,v 外的其他参数丢失 |
| 41 | Arguments wrong format | 参数格式错误, 指参数格式不满足约定 |
|
范例 | |
taobao.item.update接口调用实例 |
|
历史版本 | |
| 版本号 | 说明 |
| 1.0 |