|
taobao.items.onsale.get API功能描述 | |
| 此接口方法以实现得到当前会话用户（必须为卖家）的出售中商品列表。支持分页。 |
|
taobao.items.onsale.get API调用级别 | |
| apiType=2，所有的服务调用，需要签名校验和用户绑定。 |
|
taobao.items.onsale.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。 |
| 应用级参数 |
| 名称 | 类型 | 是否必须 | 描述 |
| fields | String | 必须 | 需要返回的商品对象字段,目前支持： iid,title,nick,type,cid,pic_path, delist_time,price,post_fee |
| q | String | 可选 | 搜索字段 |
| page_no | int | 可选 | 页码 |
| page_size | int | 可选 | 页显示数量 |
| has_discount | String | 可选 | 卖家昵称列表，逗号分隔 |
|
正常返回格式 | |
| XML数据格式 | JSON数据格式(暂不支持) |
| <?xml version="1.0" encoding="utf-8" ?> <rsp> <item> <title>iphone 8G</title> <price>5000.00</price> </item> <item> <title>iphone 4G</title> <price>4000.00</price> </item> </rsp> |
{"item":{"title":"iphone 8G","price":"5000.00"}, "item":{"title":"iphone 4G","price":"4000.00"}} |
| 返回信息 | 返回信息说明 |
| title | 商品标题 |
| price | 商品价格 |
|
异常返回格式 | |
| 系统级异常 |
| 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.items.onsale.get接口调用实例 |
|
历史版本 | |
| 版本号 | 说明 |
| 1.0 |