正常淘客万能转链API接口(联盟版) 接口在线测试

联盟官方万能转链API接口

接口地址： 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不固定且无服务器，可通过“优惠推荐”中的链接购买阿里云服务器来调用接口。禁止以插件(包括但不仅限于浏览器插件及手机插件)形式使用接口，禁止将接口重新打包销售或转卖，一经发现，将做帐号封禁处理。

优惠推荐：高性能云服务器2折起，普惠上云，仅需234元/年 ->>立即抢购<<- 。

使用说明: 暂无说明

请求参数

参数	类型	请求参数参考值	是否必须	说明
apkey	String	xxxxxxx	是	用户中心 - 系统设置 - 平台设置中查看APKEY密钥 (点我获取)（*必要）
tbname	String	xxx	是	在本平台授权的淘宝用户名
pid	String	mm_0000_0000_0000	是	淘宝联盟PID（注：如已在会员中心设置了默认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（注：如已在会员中心设置了默认渠道ID，此参数可无需再次传入）
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	请求方式不对