接口地址:
http://api.web.ecapi.cn/taoke/doTbHighCommissionPromotionUrl
接口实例:
http://api.web.ecapi.cn/taoke/doTbHighCommissionPromotionUrl?apkey=登录会员中心查看&tbname=xxx&pid=mm_0000_0000_0000&relation_id=123456
注意事项:如调用接口时数据返回异常,则需对接口中的【中文】及含有【空格】的数据进行Urlencode编码,然后再试。
请求方式:GET
会员范围:
全部会员 (新用户注册立刻送7天V1付费会员【注:赠送会员可使用全部接口,但调用频率与免费会员一致,免费会员调用频率可参考会员等级说明】)
必看注意:为保障接口安全及使用效率,调用本站接口前需先
添加IP白名单 (
IP地址测试),若IP不固定且无服务器,可通过“优惠推荐”中的链接购买阿里云服务器来调用接口。禁止以插件(包括但不仅限于浏览器插件及手机插件)形式使用接口,禁止将接口重新打包销售或转卖,一经发现,将做帐号封禁处理。
-
使用说明
-
-
请求参数
-
参数 | 类型 | 请求参数参考值 | 是否必须 | 说明 |
apkey | String | xxxxxxx | 是 | 用户中心 - 系统设置 - 平台设置 中查看APKEY密钥 (点我获取)(*必要) |
tbname | String | xxx | 是 | 在本平台授权的淘宝用户名 |
pid | String | mm_0000_0000_0000 | 是 | 淘宝联盟PID |
biz_scene_id | String | 1 | | 1-动态ID转链场景,2-消费者比价场景,4-
|
promotion_type | String | 2 | | 1-自购省,2-推广赚(代理模式专属ID,代理模式必填,其它模式不用填写本字段)
|
material_list | String | https://s.click.taobao.com/pQBDhNu,https://s.click.taobao.com/pQ | | 物料列表,可以为url或淘口令,多个时使用英文逗号拼接传入
|
relation_id | String | 123456 | 是 | 渠道管理ID(如是主站选品推广场景,必须入参该字段,且bizSceneId字段需入参2-消费者比价场景,否则二次转链失败),获取说明:https://doc.21ds.cn/detail?doc=4685763267728060/4970875219793639 |
seller_id_list | String | 123456 | | 卖家ID列表,多个时使用英文逗号拼接传入
|
item_id_list | String | qYtxrMJOC8tmtM-Qq0Z65Sbbq5DqZ9 | | 商品ID列表,多个时使用英文逗号拼接传入
|
page_id_list | String | 123456 | | 会场ID列表,多个时使用英文逗号拼接传入 |
-
返回参数
-
返回参数 | 类型 | 参数说明 | 扩展说明 |
data | Json | 返回数据 | |
├ material_url_list | String | 转链结果
| |
├ ├ msg | String | 物料对应错误描述
| |
├ ├ code | String | 物料对应错误码
| |
├ ├ promotion_info_dto | String | 营销信息
| |
├ ├ ├ commission_rate | String | 佣金率 | |
├ ├ coupon_info_dto | String | 券信息
| |
├ ├ ├ coupon_end_time | String | 优惠券结束时间
| |
├ ├ ├ activity_id | String | 券ID
| |
├ ├ ├ coupon_remain_count | String | 优惠券剩余数量
| |
├ ├ ├ coupon_amount | String | 券面额
| |
├ ├ ├ coupon_start_time | String | 优惠券开始时间
| |
├ ├ ├ coupon_desc | String | 优惠券信息,满XX元减XX元
| |
├ ├ ├ coupon_type | String | 0-店铺 1-单品 | |
├ ├ link_info_dto | String | 链接信息 | |
├ ├ ├ coupon_long_url | String | 二合一长链接
| |
├ ├ ├ material_type | String | 1—单品 2—店铺 3—会场 4-承接开放 5-优惠券
| |
├ ├ ├ tpwd_origin_url | String | 淘口令原始链接,入参物料不为淘口令时,此字段返回null
| |
├ ├ ├ material_id | String | 物料ID,需根据material_type判断物料类型, 可能为商品ID、卖家ID、会场ID
| |
├ ├ ├ cps_long_url | String | CPS链接长链
| |
├ ├ ├ cps_short_tpwd | String | CPS链接的短口令
| |
├ ├ ├ tk_biz_type | String | 1-联盟口令,2-主站口令。入参物料不为淘口令时,此字段返回null
| |
├ ├ ├ coupon_short_tpwd | String | 二合一链接的短口令
| |
├ ├ ├ cps_short_url | String | CPS链接短链
| |
├ ├ ├ coupon_short_url | String | 二合一链接长链
| |
├ ├ ├ coupon_full_tpwd | String | 二合一链接的长口令
| |
├ ├ ├ cps_full_tpwd | String | CPS链接的长口令 | |
├ shop_url_list | String | 店铺转链结果
| |
├ ├ msg | String | 物料对应错误描述
| |
├ ├ code | String | 物料对应错误码
| |
├ ├ link_info_dto | String | 链接信息 | |
├ ├ ├ material_type | String | 1—单品 2—店铺 3—会场
| |
├ ├ ├ seller_id | String | 卖家ID
| |
├ ├ ├ cps_long_url | String | 店铺CPS长链接
| |
├ ├ ├ cps_short_tpwd | String | 店铺CPS链接对应短口令
| |
├ ├ ├ cps_short_url | String | 店铺CPS短链
| |
├ ├ ├ cps_full_tpwd | String | 店铺CPS链接对应长口令 | |
├ event_url_list | String | 活动转链信息
| |
├ ├ link_info_dto | Json | 链接信息 | |
├ ├ ├ material_type | String | 1—单品 2—店铺 3—会场
| |
├ ├ ├ page_id | String | 会场ID
| |
├ ├ ├ cps_long_url | String | 会场CPS长链接
| |
├ ├ ├ cps_short_tpwd | String | 会场CPS链接的短口令
| |
├ ├ ├ cps_short_url | String | 会场CPS短链接
| |
├ ├ ├ cps_full_tpwd | String | 会场CPS链接的长口令 | |
├ item_url_list | String | 单品转链信息 | |
├ ├ promotion_info_dto | String | 营销信息
| |
├ ├ ├ commission_rate | String | 佣金率 | |
├ ├ coupon_info_dto | String | 券信息
| |
├ ├ ├ coupon_end_time | String | 优惠券结束时间
| |
├ ├ ├ activity_id | String | 券ID
| |
├ ├ ├ coupon_remain_count | String | 优惠券剩余数量
| |
├ ├ ├ coupon_amount | String | 券面额
| |
├ ├ ├ coupon_start_time | String | 优惠券开始时间
| |
├ ├ ├ coupon_desc | String | 优惠券信息,满XX元减XX元 | |
├ ├ link_info_dto | String | 链接信息 | |
├ ├ ├ coupon_long_url | String | 二合一长链接
| |
├ ├ ├ material_type | String | 1—单品 2—店铺 3—会场
| |
├ ├ ├ item_id | String | 商品ID
| |
├ ├ ├ cps_long_url | String | CPS链接长链
| |
├ ├ ├ cps_short_tpwd | String | CPS链接的短口令
| |
├ ├ ├ coupon_short_tpwd | String | 二合一链接的短口令
| |
├ ├ ├ cps_short_url | String | CPS链接短链
| |
├ ├ ├ coupon_short_url | String | 二合一链接长链
| |
├ ├ ├ coupon_full_tpwd | String | 二合一链接的长口令
| |
├ ├ ├ cps_full_tpwd | String | CPS链接的长口令 | |
-
Json返回示例
-
{
"code": 200,
"data": {
"event_url_list": [],
"item_url_list": {
"item_url_list": []
},
"material_url_list": [],
"shop_url_list": []
},
"msg": "success"
}
-
code/http_status说明
-
code/http_status | 说明 |
200 | 数据获取成功 |
-1 | 数据获取失败 |
401 | IP没有添加白名单 |
429 | 访问次数超限 |
403 | 关键参数丢失 |
405 | 请求方式不对 |