接口使用场景等说明:本接口用于获取淘宝联盟当前的官方活动列表。
环境 | http 地址 | https 地址 |
---|---|---|
正式环境 | http://api.veapi.cn/tbk/activitylist | 暂无 |
参数名称 | 参数类型 | 必填 | 示例值 | 描述 |
---|---|---|---|---|
vekey | String | 是 | V123M56 | 公共参数,接口秘钥,请在会员中心获取 |
page | Number | 否 | 1 | 页码,请根据返回值中hasMore判断是否要查询下一页。 |
pagesize | Number | 否 | 100 | 每页输出活动数,本参数暂无用处。 |
GET/POST http://api.veapi.cn/tbk/activitylist?vekey=xxx
$api="http://api.veapi.cn/tbk/activitylist?vekey=xxx"; $ch = curl_init(); curl_setopt($ch, CURLOPT_URL, $api); //curl_setopt($ch, CURLOPT_POST, true); //POST方式时启用 //curl_setopt($ch, CURLOPT_POSTFIELDS, $postData ); //POST方式时传参 curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, false); //如果使用https请启用 curl_setopt($ch, CURLOPT_SSL_VERIFYHOST, false); //如果使用https请启用 curl_setopt($ch, CURLOPT_RETURNTRANSFER, true ); //返回数据流,不直接输出 curl_setopt($ch, CURLOPT_ENCODING, 'gzip'); //使用gzip压缩传输让访问更快 curl_setopt($ch, CURLOPT_TIMEOUT, 6); //允许执行的最长秒数。这里设定6S curl_setopt($ch, CURLOPT_CONNECTTIMEOUT, 5); $result = curl_exec($ch); $info = curl_getinfo($ch); curl_close($ch); echo $result; //返回值
import cn.hutool.http.HttpResponse; import cn.hutool.http.HttpRequest; public class testGetParam { public static void main(String[] args) { // API网址 String url = "http://api.veapi.cn/tbk/activitylist?vekey=xxx"; // JDK 8u111版本后,若目标页面为HTTPS协议,请启用proxy用户密码鉴权 //System.setProperty("jdk.http.auth.tunneling.disabledSchemes", ""); // 发送请求 String result = HttpRequest.get(url) .timeout(10000)//设置超时,毫秒 .execute().body(); System.out.println(result); } }
import requests # 要访问的API网页 target_url = "http://api.veapi.cn/tbk/activitylist?vekey=xxx" # 发送请求 response = requests.get(target_url) # 获取页面内容 if response.status_code == 200: print response.text
参数名称 | 参数类型 | 示例值 | 描述 |
---|---|---|---|
total | Number | 21 | 总活动数 |
hasMore | Int | 1 | 值为1或0,是否还有活动,可用于判断是否要再传入page参数翻页,1表示下页还有活动。 |
pageName | String | 开学季主会场 | 官方活动名称 |
pageStartTime | String | 2023-07-21 00:00:00 | 活动开始时间 |
pageEndTime | String | 2023-09-30 23:59:59 | 活动结束时间 |
pageUrl | String | https://mo.m.taobao.com/union2/page_xx | 活动主场地址 |
pageId | String | 20150318020016122 | 活动ID,您可以把该ID用活动转链接口转成您的推广链接。 |
pagePictUrl | String | https://gw.alicdn.com/imgextra/....20.png | 活动封面图 |
buSourcePlatform | String | 天猫 | 活动发起平台 |
description | String | 领券满300减30 | 活动描述,该项不一定有值 |
materialOssUrl | String | https://creative-m...0150318020016407.zip | 活动物料下载地址,通常是ZIP文件 |
eventName | String | 联盟ALP单品店铺 | 活动事件名称,一般无用处。 |
{ "error": "0", "msg": "查询官方活动列表成功!", "total": 112, "hasMore": 0, "data": [ { "pageName": "超级U选|天降福利", "pageStartTime": "2023-07-21 00:00:00", "pageEndTime": "2023-09-30 23:59:59", "pageUrl": "https://mo.m.taobao.com/union2/page_1686731494574", "pageId": "20150318020016122", "pagePictUrl": "https://gw.alicdn.com/imgextra/i3/O1CN01pCOPNm1ZsY4iqfufc_!!6000000003250-2-tps-800-450.png", "buSourcePlatform": "天猫", "description": "", "materialOssUrl": null, "eventName": "方舟天猫" }, { "pageName": "开学季主会场", "pageStartTime": "2023-08-28 00:00:00", "pageEndTime": "2023-08-30 23:59:59", "pageUrl": "https://pages.tmall.com/wow/a/act/tmall/tmc/37234/19182/wupr?wh_pid=main-511202&disableNav=YES&status_bar_transparent=true", "pageId": "20150318020016403", "pagePictUrl": "https://img.alicdn.com/imgextra/i1/O1CN012rxC0p1dBH7uyb7fx_!!6000000003697-0-tps-800-450.jpg", "buSourcePlatform": "天猫", "description": "天猫开学季,满200减20", "materialOssUrl": "https://creative-material-public.oss-cn-shanghai.aliyuncs.com/a/p/20150318020016403.zip", "eventName": "方舟天猫" } ], "request_id": "drQYEK5" }