蘑菇街开放平台

API 列表

xiaodian.cpsdata.promitem.get

免费
需要授权
结果不加密

cps联盟商品(包含优惠券商品)批量查询接口(限制每秒最多请求50次)

公共参数

名称	类型	必选	描述
app_key	Long	是	接入时申请的app_key
method	String	是	接口名称
access_token	String	是	Oauth2.0授权获得的access_token
sign	String	是	对 API 调用参数（除sign外）进行 md5 加密获得。参数的顺序为字母表的顺序
timestamp	Long	是	时间戳，使用Unix时间戳格式
format	String	是	响应格式。默认为json格式，固定
sign_method	String	否	参数的加密方法选择，当前只支持Md5
version	String	否	API协议版本，固定值为：1.0

输入参数

名称	类型	必选	描述	示例值
promInfoQuery	Object	是	{ "keyword": 字符串否搜索词（商品名称关键词或商品描述关键词）, "pageNo": 整型否页码, "pageSize": 整型否每页数据个数, "sortType": 整型是0: 默认排序，11: 佣金升序，12: 佣金降序，21: 价格升序，22：价格降序，32: 销量降序，41: 优惠券升序，42: 优惠券降序, "tag": 可以不传，传1表示只查找小编精选的商品, "cid": 整型,蘑菇街商品类目id（可以通过xiaodian.item.getAllCategory api获取列表后再使用xiaodian.common.decryptID解码后得到）, "hasCoupon": 是否只返回有优惠券的商品，false返回所有商品，true只返回有优惠券的商品 }
userId	Number	是	用户ID

返回参数

名称	类型	描述	默认值
items	Object[]	商品信息列表
itemId	String	加密的商品id	qaxswd
tradeItemId	String	商品id	123456
commissionRate	String	佣金比例	12.34
zkPrice	String	原价	89.45
afterCouponPrice	String	券后价	79.45
biz30day	String	近期销量	23
title	String	商品名	a商品名称
shopTitle	String	店铺名	a店铺名称
pictUrl	String	主图	http: //jiaxing.mogutestcdn.com/p1/150815/640x960.jpg_100x100.jpg
pictUrlForH5	String	主图h5适配版本	http: //jiaxing.mogutestcdn.com/p1/150815/640x960.jpg_100x100.jpg
extendDesc	String	商品描述	韩版英伦小脚哈伦休闲裤
dayLeft	String	优惠券剩余天数	20
couponTotalCount	String	总优惠券数	3000
couponLeftCount	String	剩余优惠券数	2000
couponAmount	String	优惠券金额	10.00
couponStartFee	String	优惠券门槛	50
customImage	String	自定义图片	http: //jiaxing.mogutestcdn.com/p1/150815/640x960.jpg_100x100.jpg
customDesc	String	自定义描述	test
couponInfo	String	优惠券描述	满50可用
tag	String
cid	String	类目id	123
categoryName	String	类目	女装
shopInfo	Object
userId	String		123456
name	String		test
level	String		1
shopId	String		1234
promid	String	优惠券id	1hv5m9ypa
itemUrl	String	商品详情页url	http://shop.mogujie.com/detail/qaxswd

请求参数示例

1).
{
  "promInfoQuery": {},
  "userId": ""
}

返回示例

1).
{
    "result": {
        "data": {
            "items": [
                {
                    "itemId": "qaxswd//加密的商品id",
                    "tradeItemId": "123456//商品id",
                    "commissionRate": "12.34佣金比例",
                    "zkPrice": "89.45//原价",
                    "afterCouponPrice": "79.45//券后价",
                    "biz30day": "23//近期销量",
                    "title": "商品名称//商品名",
                    "shopTitle": "店铺名称//店铺名",
                    "pictUrl": "http:  //jiaxing.mogutestcdn.com/p1/150815/640x960.jpg_100x100.jpg//主图",
                    "pictUrlForH5": "http:  //jiaxing.mogutestcdn.com/p1/150815/640x960.jpg_100x100.jpg//主图h5适配版本",
                    "extendDesc": "韩版英伦小脚哈伦休闲裤//商品表述",
                    "dayLeft": "20//优惠券剩余天数",
                    "couponTotalCount": "3000//总优惠券数",
                    "couponLeftCount": "2000//剩余优惠券数",
                    "couponAmount": "10.00//优惠金额",
                    "couponStartFee": "50//优惠券门槛",
                    "customImage": "http:  //jiaxing.mogutestcdn.com/p1/150815/640x960.jpg_100x100.jpg //自定义图片",
                    "customDesc": "test   //自定义描述",
                    "couponInfo": "满50可用//优惠券描述",
                    "tag": "",
                    "cid": "123//类目id",
                    "categoryName": "女装//类目",
                    "shopInfo": {
                        "userId": "123456",
                        "name": "test",
                        "level": "1",
                        "shopId": "1234"
                    },
                    "promid": "1hv5m9ypa//优惠券id"
                }
            ],
            "page": 1,
            "pageSize": 10,
            "total": 232
        }
    },
    "status": {
        "code": "0000000",
        "msg": ""
    }
}

异常示例

1).
  {
        "status":{
          "code":"0000016",
          "msg": “参数异常”
        },
        "result":{
          "data":null
        }
      }

API测试工具 SDK下载