淘宝开放平台

登录
文档中心 > API类目 > 淘宝买菜

淘宝买菜

qimen.taobao.freshx.coupon.info (优惠券信息查询)

查询需要同步的历史优惠券信息

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
couponId String 必须 1234 优惠券id

响应参数

名称 类型 示例值 描述
data CouponInfo 1234 优惠券资产信息
  • └ spreadStartTime
  • String
  • 2021-03-01 00:00:00
  • 卡券传播开始时间
  • └ spreadEndTime
  • String
  • 2021-03-01 00:00:00
  • 卡券传播结束时间
  • └ outerId
  • String
  • 12345
  • 外部业务编号，幂等条件
  • └ decreaseMoney
  • Number
  • 200
  • 券面额，单位分
  • └ storeId
  • Number
  • 1
  • 站点id
  • └ title
  • String
  • 牛奶专享券
  • 券展示名称
  • └ instruction
  • String
  • 限水果类目使用
  • 券使用说明
  • └ startFee
  • Number
  • 100
  • 券使用门槛金额，精确到分
  • └ totalCount
  • Number
  • -1
  • 券模板发行量,如果不限发行量为-1
  • └ personLimitCount
  • Number
  • 1000
  • 每人限领数量
  • └ effectiveTimeMode
  • Number
  • 1
  • 有效时间模式
  • └ effectiveStartInterval
  • Number
  • 86400
  • 购后之后有效时间开始
  • └ type
  • Number
  • 1
  • 优惠券类型：1-店铺通用券；2-店铺品类券；3-单品券
  • └ itemId
  • Number
  • 1
  • 商品id
  • └ categoryList
  • String
  • [1,2,3]
  • 类目列表
  • └ onlyNewUser
  • Boolean
  • false
  • 是否新人专享
  • └ effectiveInterval
  • Number
  • 86400
  • 领取／发放／购买后的有效时长（单位s）
  • └ effectiveStartTime
  • String
  • 2021-03-01 00:00:00
  • 卡券有效开始时间
  • └ effectiveEndTime
  • String
  • 2021-03-31 00:00:00
  • 卡券有效结束时间
success Boolean true 调用结果
errorMessage String sys_error 错误信息
errorCode String -1 错误code

请求示例

{"couponId":"1234"}

响应示例

{
    "data":{
        "spreadStartTime":"2021-03-01 00:00:00",
        "spreadEndTime":"2021-03-01 00:00:00",
        "outerId":"12345",
        "decreaseMoney":200,
        "storeId":1,
        "title":"牛奶专享券",
        "instruction":"限水果类目使用",
        "startFee":100,
        "totalCount":-1,
        "personLimitCount":1000,
        "effectiveTimeMode":1,
        "effectiveStartInterval":86400,
        "type":1,
        "itemId":1,
        "categoryList":"[1,2,3]",
        "onlyNewUser":false,
        "effectiveInterval":86400,
        "effectiveStartTime":"2021-03-01 00:00:00",
        "effectiveEndTime":"2021-03-31 00:00:00"
    },
    "success":true,
    "errorMessage":"sys_error",
    "errorCode":"-1"
}

验签示例

{"success":"false","errorMessage":"Illegal request","errorCode":"sign-check-failure"}

错误码解释

错误码 错误描述 解决方案

API工具

错误码查询工具 SDK下载

FAQ

有用( 0 ) 我要提问
返回
顶部