接口使用场景等说明:工具商媒体帮助推客查询推广位,推广位分为两种类型:
3:私域推广位,上限5000个,不在联盟后台展示,无对应 PID;
4:联盟后台推广位,上限500个,在联盟后台展示,可用于内容平台推广。
当您在创建PID推广时,使用的是unionType=3参数,那么在京东联盟后台是看不到这个推广位,因此,查询时也应该传入unionType=3
业务参数key需要由推客进入“联盟官网-我的推广-我的工具-我的API”中查询,有效期365天。
环境 | http 地址 | https 地址 |
---|---|---|
正式环境 | http://api.veapi.cn/jd/pidquery | 暂无 |
参数名称 | 参数类型 | 必填 | 示例值 | 描述 |
---|---|---|---|---|
vekey | String | 是 | V123M56 | 公共参数,接口秘钥,请在会员中心获取 |
unionId | Number | 是 | 10000618 | 需要查询的目标联盟id |
key | String | 是 | 无 | 推客unionid对应的“授权Key”,在联盟官网-我的工具-我的API中查询,授权Key具有唯一性,有效期365天,删除或创建新的授权Key后原有的授权Key自动失效 |
unionType | Number | 是 | 3 | 3:私域推广位,上限5000个,不在联盟后台展示,无对应PID;4:联盟后台推广位,上限500个,会在推客联盟后台展示,可用于内容平台推广 |
pageIndex | Number | 是 | 1 | 页码,上限100 |
pageSize | Number | 是 | 20 | 每页条数,上限100 |
GET/POST http://api.veapi.cn/jd/pidquery?vekey=xxx&unionId=1001034551&key=ece3b6ab1c8b87a738757bac144b52defe3346604e5f47a25132578be8101ea45b41f24d5ea6a829&unionType=3&pageIndex=1
$api="http://api.veapi.cn/jd/pidquery?vekey=xxx&unionId=1001034551&key=ece3b6ab1c8b87a738757bac144b52defe3346604e5f47a25132578be8101ea45b41f24d5ea6a829&unionType=3&pageIndex=1"; $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/jd/pidquery?vekey=xxx&unionId=1001034551&key=ece3b6ab1c8b87a738757bac144b52defe3346604e5f47a25132578be8101ea45b41f24d5ea6a829&unionType=3&pageIndex=1"; // 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/jd/pidquery?vekey=xxx&unionId=1001034551&key=ece3b6ab1c8b87a738757bac144b52defe3346604e5f47a25132578be8101ea45b41f24d5ea6a829&unionType=3&pageIndex=1" # 发送请求 response = requests.get(target_url) # 获取页面内容 if response.status_code == 200: print response.text
参数名称 | 参数类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
id | Number | 是 | 6188886186 | 推广位ID |
siteId | Number | 是 | 0 | 站点ID,如网站ID/appID/snsID |
spaceName | String | 是 | test3 | 推广位名称 |
type | Number | 是 | 4 | 站点类型 1.网站推广位2.APP推广位3.导购媒体推广位4.聊天工具推广位 |
pid | String | 否 | 52267_4000000060_3000197007 | pid:仅uniontype传4时,展示pid;可用于内容平台推广 |
total | Number | 是 | 3 | 总数 |
{ "error": "0", "msg": "查询成功!", "data": { "pageNo": "1", "pageSize": "20", "result": [ { "id": "21001919639", "siteId": "1487944623", "spaceName": "新PID202301", "type": "1" }, { "id": "21001919637", "siteId": "1487944623", "spaceName": "新京推1", "type": "1" }, { "id": "21001919622", "siteId": "1487944623", "spaceName": "新京推1", "type": "1" }, { "id": "21001919620", "siteId": "1487944623", "spaceName": "新京推1", "type": "1" } ], "total": "4" }, "request_id": "tk8Cy33" }