口碑城市生活周:http://pages.tmall.com/wow/alsc/mod/c9e5472d65868f931d350439
活动ID:1583739244161
| 参数 | 类型 | 请求参数参考值 | 是否必须 | 说明 |
| apkey | String | xxxxxxx | 是 | 用户中心 - 系统设置 - 平台设置 中查看APKEY密钥 (点我获取)(*必要) |
| tbname | String | xxxx | 是 | 在本平台授权的淘宝用户名,有中文时需进行Urlencode编码 |
| pid | String | mm_123456_456789_789132 | 是 | 淘宝联盟PID(注:如已在会员中心设置了默认PID,此参数可无需再次传入) |
| activity_material_id | String | xxxx | 是 | 活动ID,支持通过推广位和活动物料id获取活动详情,包含推广url(长链、短链),淘口令、微信推广二维码地址等。淘宝联盟官方活动推广API-工具,支持二方、三方 |
| relation_id | String | xxxx | 是 | 渠道关系id,获取说明:https://doc.21ds.cn/detail?doc=4685763267728060/4970875219793639(注:如已在会员中心设置了默认渠道ID,此参数可无需再次传入) |
| hastpwd | String | 1 | 是否生成淘口令,1为生成,不填或填写其他为不生成,如果生成,则tpwd_title参数必须传入,否则不生效 | |
| tpwd_title | String | 淘口令标题 | 与hastpwd配合使用 | |
| union_id | String | Vxxxxxxx | 自定义输入串,英文和数字组成,长度不能大于12个字符,区分不同的推广渠道 |
| 返回参数 | 类型 | 参数说明 | 扩展说明 |
| data | Json | 返回数据列表 | |
| ├ click_url | String | 活动推广地址 | |
| ├ tpwd | String | 活动推广地址对应的淘口令 | 此为可选项,详见入参说明 |
| ├ wx_qrcode_url | String | 微信小程序推广二维码地址 | 【本地化】微信推广二维码地址 |
| ├ short_click_url | String | 推广短链 | |
| ├ terminal_type | String | 投放平台, 1-PC 2-无线 | |
| ├ material_oss_url | String | 物料素材下载地址 | |
| ├ page_name | String | 会场名称 | |
| ├ page_start_time | String | 活动开始时间 | |
| ├ page_end_time | String | 活动结束时间活动结束时间 | |
| ├ wx_miniprogram_path | String | 【本地化】微信小程序推广路径 |
{"code":200,"data":{"click_url":"https://s.click.koubei.com/t?&e=-s02yxxxxx01","tpwd":"¥75xxxx0Q¥"},"msg":"success"}
| code/http_status | 说明 |
| 200 | 数据获取成功 |
| -1 | 数据获取失败 |
| 401 | IP没有添加白名单 |
| 429 | 访问次数超限 |
| 403 | 关键参数丢失 |
| 405 | 请求方式不对 |