淘宝开放平台

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

淘宝客API

qimen.taobao.tbk.item.rule.get (淘宝客商品展示规则获取)

获取商品详情／购物车小程序中可定制点的信息，如指定券ID，返利比例等

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
itemIds String 必须 23423,3343 商品ID，多个用,隔开
isvUserId String 可选 ere234ddf 媒体上下文用户参数（便于媒体决策版本和入参）
itemsData ItemData [] 可选
  • 最大列表长度：999
    		•  商品信息列表，列表商品顺序和itemIds一致
    • └ itemPrice
    • String
    • 可选
    • 20.01
    • 商品在线价，单位元，保留两位小数
    • └ itemCouponAmount
    • String
    • 可选
    • 10.01
    • 商品最优券面额，单位元，保留两位小数
    • └ itemCommission
    • String
    • 可选
    • 4501
    • 商品最高佣金率（不包含定向计划），4501表示45.01%

    响应参数

    名称 类型 示例值 描述
    result RuleResult 结果
    • data
    • RuleData []
    • 返回数据
    • └ flRate
    • String
    • 4501
    • 返利比例，4501表示45.01%，当页面类型为返利时需要
    • └ itemId
    • String
    • 343434
    • 商品ID
    • └ pageType
    • String
    • fl
    • 媒体设置的当前页面类型：导购版本为guide、渠道管理版本为agent、返利版本为rebate
    • └ couponActivityId
    • String
    • xcxwerew
    • 优惠券ID
    • └ dlRate
    • String
    • 1201
    • 代理比例，1201表示12.01%，当页面类型为代理时需要
    • └ vegasCode
    • String
    • xxxx
    • 淘礼金vegas_code（淘礼金创建API(tbk_dg_vegas_tlj_create)I生成的返回字段中的vegas_code值），注意生成的淘礼金pid和打开详情页的pid需要保持一致，不然会导致淘礼金领取失败
    • └ flAmount
    • String
    • 5.01
    • 当前用户返利金额，单位元，保留两位小数，当页面类型为返利时需要
    • └ dlAmount
    • String
    • 6.02
    • 当前用户渠道金额，单位元，保留两位小数，当页面类型为代理时需要
    • └ maxDlRate
    • String
    • 5120
    • 返利最高比例，5120表示51.20%，当页面类型为代理时需要
    • └ maxDlAmount
    • String
    • 7.03
    • 当前用户最高渠道金额，单位元，保留两位小数，当页面类型为代理时需要
    • └ success
    • Boolean
    • true
    • 是否成功，true|成功，false|失败
    • └ errorMessage
    • String
    • 系统错误
    • 错误信息
    • └ errorCode
    • String
    • SYSTEERROR
    • 错误码

    请求示例

    {"itemIds":"23423,3343","isvUserId":"ere234ddf","itemsData":[{"itemCouponAmount":"10.01","itemPrice":"20.01","itemCommission":"4501"}]}

    响应示例

    {
    "result":{
        "data":[
            {
                    "flRate":"4501",
                    "itemId":"343434",
                    "pageType":"fl",
                    "couponActivityId":"xcxwerew",
                    "dlRate":"1201",
                    "vegasCode":"xxxx",
                    "flAmount":"5.01",
                    "dlAmount":"6.02",
                    "maxDlRate":"5120",
                    "maxDlAmount":"7.03"
            }
        ],
        "success":true,
        "errorMessage":"系统错误",
        "errorCode":"SYSTEERROR"
    }
}

    验签示例

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

    错误码解释

    错误码 错误描述 解决方案

    API工具

    错误码查询工具 SDK下载

    FAQ

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