接口地址:
http://api.web.ecapi.cn/pinduoduo/generalThemePromUrl
接口实例:
http://api.web.ecapi.cn/pinduoduo/generalThemePromUrl?apkey=登录会员中心查看&pdname=xxxxxx&theme_id_list=7602&pid=xxxx
注意事项:如调用接口时数据返回异常,则需对接口中的【中文】及含有【空格】的数据进行Urlencode编码,然后再试。
请求方式:GET
会员范围:
全部会员 (新用户注册立刻送7天V1付费会员【注:赠送会员可使用全部接口,但调用频率与免费会员一致,免费会员调用频率可参考会员等级说明】)
必看注意:为保障接口安全及使用效率,调用本站接口前需先
添加IP白名单 (
IP地址测试),若IP不固定且无服务器,可通过“优惠推荐”中的链接购买阿里云服务器来调用接口。禁止以插件(包括但不仅限于浏览器插件及手机插件)形式使用接口,禁止将接口重新打包销售或转卖,一经发现,将做帐号封禁处理。
-
使用说明
-
-
请求参数
-
参数 | 类型 | 请求参数参考值 | 是否必须 | 说明 |
apkey | String | xxxxxxx | 是 | 用户中心 - 系统设置 - 平台设置 中查看APKEY密钥 (点我获取)(*必要) |
pdname | String | xxxxxx | 是 | 在本平台授权的拼多多用户名 |
theme_id_list | String | 7602 | 是 | 主题ID列表,例如:1,235,7602 |
pid | String | xxxx | 是 | 推广位ID |
custom_parameters | String | xxxxxx | | 自定义参数,为链接打上自定义标签;自定义参数最长限制64个字节;格式为: {"uid":"11111","sid":"22222"} ,其中 uid 用户唯一标识,可自行加密后传入,每个用户仅且对应一个标识,必填; sid 上下文信息标识,例如sessionId等,非必填。该json字符串中也可以加入其他自定义的key |
generate_mobile | String | true | | 是否生成手机跳转链接。true-是,false-否,默认false |
generate_qq_app | String | true | | 是否生成qq小程序 |
generate_schema_url | String | true | | 是否返回 schema URL |
generate_short_url | String | true | | 是否生成短链接,true-是,false-否 |
generate_weapp_webview | String | true | | 是否唤起微信客户端, 默认false 否,true 是 |
generate_we_app | String | true | | 是否生成小程序链接 |
-
返回参数
-
返回参数 | 类型 | 参数说明 | 扩展说明 |
url_list | Json | 主题活动推广url列表 | |
├ mobile_short_url | String | 主题活动推广移动短链接 | |
├ mobile_url | String | 主题活动推广移动链接 | |
├ multi_group_mobile_short_url | String | 主题活动推广开团移动端短链接 | |
├ multi_group_mobile_url | String | 主题活动推广开团移动端链接 | |
├ multi_group_short_url | String | 主题活动推广开团短链接 | |
├ multi_group_url | String | 主题活动推广开团链接 | |
├ qq_app_info | Json | qq小程序信息 | |
├ ├ app_id | String | 拼多多小程序id | |
├ ├ banner_url | String | Banner图 | |
├ ├ desc | String | 描述 | |
├ ├ page_path | String | 小程序path值 | |
├ ├ qq_app_icon_url | String | 小程序icon | |
├ ├ source_display_name | String | 来源名 | |
├ ├ title | String | 小程序标题 | |
├ ├ user_name | String | 用户名 | |
├ schema_url | String | schema的链接 | |
├ short_url | String | 主题活动推广短链 | |
├ url | String | 主题活动推广链接 | |
├ we_app_info | Json | 小程序信息 | 参数字段参考qq_app_info |
-
Json返回示例
-
{"code":200,"data":{"url_list":[{"multi_group_url":"https://mobile.yangkeduo.com/duo_theme_activity.html?themeId=7602&pid=1755220_122327404&authDuoId=1755220&cpsSign=CT_200903_1755220_122327404_ddba9e45928971d4a4de76a58ad8bcdf&duoduo_type=3","url":"https://mobile.yangkeduo.com/duo_theme_activity.html?themeId=7602&pid=1755220_122327404&authDuoId=1755220&cpsSign=CT_200903_1755220_122327404_ddba9e45928971d4a4de76a58ad8bcdf&duoduo_type=2"}]},"msg":"success"}
-
code/http_status说明
-
code/http_status | 说明 |
200 | 数据获取成功 |
-1 | 数据获取失败 |
401 | IP没有添加白名单 |
429 | 访问次数超限 |
403 | 关键参数丢失 |
405 | 请求方式不对 |