- pinke
- init
- getCats(
- getAllOrderListIncrement
- getGoodsDetail
- getGoodsSearch
- goodsPidQuery
- getPidGenerate
- getGoodsPromotionUrlGenerate
- getOrderListIncrement
- getGoodsOpt
- getRpPromUrlGenerate
- getCmsPromUrlGenerate
- getThemeList
- getThemeGoodsSearch
- getThemePromUrlGenerate
- getDirectGoodsQuery
- getGoodsZsUnitUrlGen
- getWeappQrcodeUrlGen
- getGoodsBasicInfo
- getGoodsRecommend
- getOrderDetail
- getMallGoodsList
- getMallUrlGen
- getLotteryUrlGen
- getLotteryNewList
- getResourceUrlGen
- getMerchantList
- getTopGoodsList
- 其他
- \==申请流程==
pinke
来自于:开发者立即使用
init getCats getAllOrderListIncrement getGoodsDetail getGoodsSearch goodsPidQuery getPidGenerate getGoodsPromotionUrlGenerate getOrderListIncrement getGoodsOpt getRpPromUrlGenerate getCmsPromUrlGenerate getThemeList getThemeGoodsSearch getThemePromUrlGenerate getDirectGoodsQuery getGoodsZsUnitUrlGen getWeappQrcodeUrlGen getGoodsBasicInfo getGoodsRecommend getOrderDetail getMallGoodsList getMallUrlGen getLotteryUrlGen getLotteryNewList getResourceUrlGen getMerchantList getTopGoodsList
模块概述
本模块实封装了多多客开放接口,针对多多进宝的商品,推荐导购并赚取CPS佣金。用户需到多多进宝网站申请,具体流程见文档底部。
针对多多联盟类应用的接口封装,可直接调用接口,使用此模版需调用init()方法初始化(初始化一次即可)。
配置: 需在config文件下配置key相关信息(申请流程见底部)。
<feature name="pinke">
<param name="clientId" value="7dfa49729XXXXXXXXX"/>
<param name="clientSecret" value="8d55ee3XXXXXXXXXX"/>
</feature>
目前暂只支持安卓,后期将追加ios相关支持。
模块接口
init
初始化模块
init()
params
callback(ret, err)
示例代码
var pinke = api.require('pinke');
pinke.init();
getCats(
查询类目信息
getCats({params},callback(ret, err))
params
cartId :
- 类型:long
- 描述:(必填项)查询类目的父节点id,根节点为0
- 默认值:0
callback(ret, err)
ret:
- 类型:JSON 对象
- 内部字段:
{
data:
{
goods_cats_list:[{
cat_id : 69, // 类目ID
cat_name : 美容护肤/精油, // 类目名称
level : 1, // 类目级别
parent_cat_id // 所属父类目id
}]
}
}
err:
- 类型:JSON 对象
- 内部字段:
{
errCode: 0 // 错误码,请参照最下方错误code详情地址
errMsg : "" // 请配置正确的clientId 和 secret 及必填参数
}
示例代码
var pinke = api.require('pinke');
pinke.getCats({catId,0},function(ret,err){
alert(JSON.stringify(ret));
alert(JSON.stringify(err));
});
getAllOrderListIncrement
查询订单列表
getAllOrderListIncrement({params},callback(ret, err))
(此接口已过时,请使用getOrderListIncrement)
params
param:
- 类型 : JSON
- 描述 : 查询条件
{
start_update_time:
- 类型 : LONG
- 描述 : (必填)最近90天内多多进宝商品订单更新时间--查询时间开始。
time为unix时间戳。
- 默认值 : 无
end_update_time:
- 类型 : LONG
- 描述 : (必填)查询结束时间,和开始时间相差不能超过24小时。
- 默认值 : 无
page_size:
- 类型 : INTEGER
- 描述 : 返回的每页结果订单数
- 默认值:100
page:
- 类型 : INTEGER
- 描述 : 页数
- 默认值:1
return_count:
- 类型 : BOOLEAN
- 描述 : 是否返回总数
- 默认值:true
}
callback(ret, err)
ret:
- 类型:JSON 对象
- 内部字段:
{
total_count: 0 // LONG;true,请求到的结果数
order_list : [] // 数组返回参数详见下方链接
}
https://open.pinduoduo.com/#/apidocument/port?id=pdd.ddk.order.list.increment.get
err:
- 类型:JSON 对象
- 内部字段:
{
errCode: 0 // 错误码,请参照最下方错误code详情地址
errMsg : "" // 请配置正确的clientId 和 secret 及必填参数
}
示例代码
var pinke = api.require('pinke');
pinke.getAllOrderListIncrement({
param : {
start_update_time:1523457600,
end_update_time:1555343999
}
},function(ret,err){
alert(JSON.stringify(ret));
alert(JSON.stringify(err));
});
getGoodsDetail
查询商品详情
getGoodsDetail({params},callback(ret, err))
params
param:
- 类型 : JSON
- 描述 : 查询条件
{
goods_id_list:
- 类型 : LONG[]
- 描述 : (必填)商品ID,仅支持单个查询。例如:[123456]
- 默认值 : 无
pid:
- 类型 : STRING
- 描述 : (可选项)推广位id
- 默认值 : 无
custom_parameters:
- 类型 : STRING
- 描述 : (可选项)自定义参数
- 默认值 : 无
zs_duo_id:
- 类型 : LONG
- 描述 : (可选项)招商多多客ID
- 默认值 : 无
plan_type:
- 类型 : INTEGER
- 描述 : (可选项)佣金优惠券对应推广类型,3:专属 4:招商
- 默认值 : 无
}
callback(ret, err)
ret:
- 类型:JSON 对象
- 内部字段:
{
goods_details : [] // 数组返回参数详见下方链接
}
https://open.pinduoduo.com/#/apidocument/port?id=pdd.ddk.goods.detail
err:
- 类型:JSON 对象
- 内部字段:
{
errCode: 0 // 错误码,请参照最下方错误code详情地址
errMsg : "" // 请配置正确的clientId 和 secret 及必填参数
}
示例代码
var pinke = api.require('pinke');
pinke.getGoodsDetail({
param : {
goods_id_list: [4435268166]
}
},function(ret,err){
alert(JSON.stringify(ret));
alert(JSON.stringify(err));
});
getGoodsSearch
商品搜索
getGoodsSearch({params},callback(ret, err))
params
param:
- 类型 : JSON
- 描述 : 查询条件
{
keyword:
- 类型 : STRING
- 描述 : (可选项)商品关键词,与opt_id字段选填一个或全部填写
- 默认值 : 无
opt_id:
- 类型 : LONG
- 描述 : (可选项)商品标签类目ID
- 默认值 : 无
page:
- 类型 : INTEGER
- 描述 : (可选项)商品分页数
- 默认值 : 1
page_size:
- 类型 : INTEGER
- 描述 : (可选项)每页商品数量
- 默认值 : 100
sort_type:
- 类型 : INTEGER
- 描述 : (可选项)排序方式:0-31 可至下方此接口链接处查询
- 默认值 : 0
with_coupon:
- 类型 : BOOLEAN
- 描述 : (可选项)是否只返回优惠券的商品
- 默认值 : false
range_list:
- 类型 : INTEGER
- 描述 : (可选项)筛选范围:[{"range_id":0,"range_from":1,"range_to":1500},{"range_id":1,"range_from":1,"range_to":1500}]
- 默认值 : 无
cat_id:
- 类型 : LONG
- 描述 : (可选项)商品类目ID
- 默认值 : 无
goods_id_list:
- 类型 : LONG[]
- 描述 : (可选项)商品ID列表。例如:[123456,123]
- 默认值 : 无
merchant_type:
- 类型 : LONG[]
- 描述 : (可选项)商品ID列表。例如:[123456,123]
- 默认值 : 无
pid:
- 类型 : STRING
- 描述 : (可选项)推广位id
- 默认值 : 无
custom_parameters:
- 类型 : STRING
- 描述 : (可选项)自定义参数
- 默认值 : 无
}
callback(ret, err)
ret:
- 类型:JSON 对象
- 内部字段:
{
goods_list : [] // 数组中返回参数详见下方链接
}
https://open.pinduoduo.com/#/apidocument/port?id=pdd.ddk.goods.search
err:
- 类型:JSON 对象
- 内部字段:
{
errCode: 0 // 错误码,请参照最下方错误code详情地址
errMsg : "" // 请配置正确的clientId 和 secret 及必填参数
}
示例代码
var pinke = api.require('pinke');
pinke.getGoodsSearch({
param : {
keyword:'耐克'
}
},function(ret,err){
alert(JSON.stringify(ret));
alert(JSON.stringify(err));
});
goodsPidQuery
查询多多进宝推广位
goodsPidQuery({params},callback(ret, err))
params
param:
- 类型 : JSON
- 描述 : 查询条件
{
page:
- 类型 : INTEGER
- 描述 : (可选项)返回的页数
- 默认值 : 1
page_size:
- 类型 : INTEGER
- 描述 : (可选项)返回的每页推广位数量
- 默认值 : 100
}
callback(ret, err)
ret:
- 类型:JSON 对象
- 内部字段:
{
total_count:0, // 总数
p_id_list : [] // 数组中返回参数详见下方链接
}
https://open.pinduoduo.com/#/apidocument/port?id=pdd.ddk.goods.pid.query
err:
- 类型:JSON 对象
- 内部字段:
{
errCode: 0 // 错误码,请参照最下方错误code详情地址
errMsg : "" // 请配置正确的clientId 和 secret 及必填参数
}
示例代码
var pinke = api.require('pinke');
pinke.goodsPidQuery({
param : {
}
},function(ret,err){
alert(JSON.stringify(ret));
alert(JSON.stringify(err));
});
getPidGenerate
创建多多进宝推广位
getPidGenerate({params},callback(ret, err))
params
param:
- 类型 : JSON
- 描述 : 查询条件
{
number:
- 类型 : LONG
- 描述 : (必填项)要生成的推广位数量
- 默认值 : 无
p_id_name_list:
- 类型 : STRING[]
- 描述 : (可选项)推广位名称
- 默认值 : 无
}
callback(ret, err)
ret:
- 类型:JSON 对象
- 内部字段:
{
p_id_list : [] // 数组中返回参数详见下方链接
}
https://open.pinduoduo.com/#/apidocument/port?id=pdd.ddk.goods.pid.generatey
err:
- 类型:JSON 对象
- 内部字段:
{
errCode: 0 // 错误码,请参照最下方错误code详情地址
errMsg : "" // 请配置正确的clientId 和 secret 及必填参数
}
示例代码
var pinke = api.require('pinke');
pinke.getPidGenerate({
param : {
number : 1,
p_id_name_list : ['测试推广位']
}
},function(ret,err){
alert(JSON.stringify(ret));
alert(JSON.stringify(err));
});
getGoodsPromotionUrlGenerate
生成普通商品推广链接
getGoodsPromotionUrlGenerate({params},callback(ret, err))
params
param:
- 类型 : JSON
- 描述 : 查询条件
{
p_id:
- 类型 : STRING
- 描述 : (必填)推广位ID
- 默认值 : 无
goods_id_list:
- 类型 : LONG[]
- 描述 : (必填)商品ID,仅支持单个查询
- 默认值 : 无
generate_short_url:
- 类型 : BOOLEAN
- 描述 : (可选项)是否生成短链接
- 默认值 : false
multi_group:
- 类型 : BOOLEAN
- 描述 : (可选项)true--生成多人团推广链接 false--生成单人团推广链接
- 默认值 : false
custom_parameters:
- 类型 : STRING
- 描述 : (可选项)自定义参数
- 默认值 : 100
generate_weapp_webview:
- 类型 : BOOLEAN
- 描述 : (可选项)是否生成唤起微信客户端链接
- 默认值 : false
zs_duo_id:
- 类型 : LONG
- 描述 : (可选项)招商多多客ID
- 默认值 : 无
generate_we_app:
- 类型 : BOOLEAN
- 描述 : (可选项)是否生成小程序推广
- 默认值 : false
}
callback(ret, err)
ret:
- 类型:JSON 对象
- 内部字段:
{
goods_promotion_url_list : [] // 数组中返回参数详见下方链接
}
https://open.pinduoduo.com/#/apidocument/port?id=pdd.ddk.goods.promotion.url.generate
err:
- 类型:JSON 对象
- 内部字段:
{
errCode: 0 // 错误码,请参照最下方错误code详情地址
errMsg : "" // 请配置正确的clientId 和 secret 及必填参数
}
示例代码
var pinke = api.require('pinke');
pinke.getGoodsPromotionUrlGenerate({
param : {
p_id : '8346732_52548325',
goods_id_list : [4435268166]
}
},function(ret,err){
alert(JSON.stringify(ret));
alert(JSON.stringify(err));
});
getOrderListIncrement
最后更新时间段增量同步推广订单信息
getOrderListIncrement({params},callback(ret, err))
params
param:
- 类型 : JSON
- 描述 : 查询条件
{
start_update_time:
- 类型 : LONG
- 描述 : (必填)最近90天内多多进宝商品订单更新时间--查询时间开始。
time为unix时间戳。
- 默认值 : 无
end_update_time:
- 类型 : LONG
- 描述 : (必填)查询结束时间,和开始时间相差不能超过24小时。
- 默认值 : 无
page_size:
- 类型 : INTEGER
- 描述 : 返回的每页结果订单数
- 默认值:100
page:
- 类型 : INTEGER
- 描述 : 页数
- 默认值:1
return_count:
- 类型 : BOOLEAN
- 描述 : 是否返回总数
- 默认值:true
}
callback(ret, err)
ret:
- 类型:JSON 对象
- 内部字段:
{
total_count:0, // 总数
order_list : [] // 数组中返回参数详见下方链接
}
https://open.pinduoduo.com/#/apidocument/port?id=pdd.ddk.order.list.increment.get
err:
- 类型:JSON 对象
- 内部字段:
{
errCode: 0 // 错误码,请参照最下方错误code详情地址
errMsg : "" // 请配置正确的clientId 和 secret 及必填参数
}
示例代码
pinke.getOrderListIncrement({
param : {
start_update_time:1523457600,
end_update_time:1555343999
}
},function(ret,err){
alert(JSON.stringify(ret));
alert(JSON.stringify(err));
});
getGoodsOpt
获得商品便签列表
getGoodsOpt({params},callback(ret, err))
params
param:
- 类型 : JSON
- 描述 : 查询条件
{
parent_opt_id:
- 类型 : INTEGER
- 描述 : (必填)值=0时为顶点opt_id,通过树顶级节点获取opt树
- 默认值 : 无
}
callback(ret, err)
ret:
- 类型:JSON 对象
- 内部字段:
{
goods_opt_list : [] // 数组中返回参数详见下方链接
}
https://open.pinduoduo.com/#/apidocument/port?id=pdd.goods.opt.get
err:
- 类型:JSON 对象
- 内部字段:
{
errCode: 0 // 错误码,请参照最下方错误code详情地址
errMsg : "" // 请配置正确的clientId 和 secret 及必填参数
}
示例代码
var pinke = api.require('pinke');
pinke.getGoodsOpt({
parent_opt_id : 0
},function(ret,err){
alert(JSON.stringify(ret));
alert(JSON.stringify(err));
});
getRpPromUrlGenerate
生成红包推广链接接口
getRpPromUrlGenerate({params},callback(ret, err))
params
param:
- 类型 : JSON
- 描述 : 查询条件
{
generate_short_url:
- 类型 : BOOLEAN
- 描述 : (可选项)是否生成短链接。true-是,false-否
- 默认值 : false
p_id_list:
- 类型 : STRING[]
- 描述 : (必填)推广位列表,例如:["60005_612"]
- 默认值 : 无
custom_parameters:
- 类型 : STRING
- 描述 : (可选项)自定义参数,为链接打上自定义标签
- 默认值 : 无
generate_weapp_webview:
- 类型 : BOOLEAN
- 描述 : (必填)是否唤起微信客户端
- 默认值 : false
we_app_web_view_short_url:
- 类型 : BOOLEAN
- 描述 : (可选项)唤起微信app推广短链接
- 默认值 : 无
p_id_list:
- 类型 : BOOLEAN
- 描述 : (可选项)唤起微信app推广链接
- 默认值 : 无
p_id_list:
- 类型 : BOOLEAN
- 描述 : (可选项)是否生成小程序推广
- 默认值 : 无
}
callback(ret, err)
ret:
- 类型:JSON 对象
- 内部字段:
{
url_list : [] // 数组中返回参数详见下方链接
}
https://open.pinduoduo.com/#/apidocument/port?id=pdd.ddk.rp.prom.url.generate
err:
- 类型:JSON 对象
- 内部字段:
{
errCode: 0 // 错误码,请参照最下方错误code详情地址
errMsg : "" // 请配置正确的clientId 和 secret 及必填参数
}
示例代码
var pinke = api.require('pinke');
pinke.getRpPromUrlGenerate({
param : {
p_id_list : ['8346732_52548325'],
generate_weapp_webview : true
}
},function(ret,err){
alert(JSON.stringify(ret));
alert(JSON.stringify(err));
});
getCmsPromUrlGenerate
生成商城推广链接
getCmsPromUrlGenerate({params},callback(ret, err))
params
param:
- 类型 : JSON
- 描述 : 查询条件
{
we_app_web_view_short_url:
- 类型 : BOOLEAN
- 描述 : (必填)唤起微信app推广短链接
- 默认值 : 无
we_app_web_view_url:
- 类型 : BOOLEAN
- 描述 : (必填)唤起微信app推广链接
- 默认值 : 无
generate_short_url:
- 类型 : BOOLEAN
- 描述 : (可选项)是否生成短链接量
- 默认值 : false
generate_mobile:
- 类型 : BOOLEAN
- 描述 : (可选项)是否生成手机跳转链接
- 默认值 : false
multi_group:
- 类型 : BOOLEAN
- 描述 : (可选项)单人团多人团标志。true-多人团,false-单人团
- 默认值 : false
custom_parameters:
- 类型 : LONG
- 描述 : (可选项)返回的每页推广位数量
- 默认值 : 无
generate_weapp_webview:
- 类型 : BOOLEAN
- 描述 : (可选项)是否唤起微信客户端, 默认false 否,true 是
- 默认值 : false
channel_type:
- 类型 : INTEGER
- 描述 : (可选项)0, "1.9包邮";1, "今日爆款"; 2, "品牌清仓"; 4,"PC端专属商城";5, "养宝宝兑现金";不传值为默认商城
- 默认值 : 无
p_id_list:
- 类型 : STRING[]
- 描述 : (可选项)推广位列表,例如:["60005_612"]
- 默认值 : 无
}
callback(ret, err)
ret:
- 类型:JSON 对象
- 内部字段:
{
total:0, // 总数
url_list : [] // 数组中返回参数详见下方链接
}
https://open.pinduoduo.com/#/apidocument/port?id=pdd.ddk.cms.prom.url.generate
err:
- 类型:JSON 对象
- 内部字段:
{
errCode: 0 // 错误码,请参照最下方错误code详情地址
errMsg : "" // 请配置正确的clientId 和 secret 及必填参数
}
示例代码
var pinke = api.require('pinke');
pinke.getCmsPromUrlGenerate({
param : {
p_id_list : ["8346732_52548325"],
generate_short_url : true,
generate_mobile : true,
channel_type : 1 ,
we_app_web_view_url : true,
we_app_web_view_short_url : true
}
},function(ret,err){
alert(JSON.stringify(ret));
alert(JSON.stringify(err));
});
getThemeList
查询多多进宝主题列表
getThemeList({params},callback(ret, err))
params
param:
- 类型 : JSON
- 描述 : 查询条件
{
page:
- 类型 : INTEGER
- 描述 : (可选项)返回的页数
- 默认值 : 1
page_size:
- 类型 : INTEGER
- 描述 : (可选项)返回的每页推广位数量
- 默认值 : 100
}
callback(ret, err)
ret:
- 类型:JSON 对象
- 内部字段:
{
total:0, // 总数
theme_list : [] // 数组中返回参数详见下方链接
}
https://open.pinduoduo.com/#/apidocument/port?id=pdd.ddk.theme.list.get
err:
- 类型:JSON 对象
- 内部字段:
{
errCode: 0 // 错误码,请参照最下方错误code详情地址
errMsg : "" // 请配置正确的clientId 和 secret 及必填参数
}
示例代码
var pinke = api.require('pinke');
pinke.getThemeList({
param : {
}
},function(ret,err){
alert(JSON.stringify(ret));
alert(JSON.stringify(err));
});
getThemeGoodsSearch
多多进宝主题商品查询
getThemeGoodsSearch({params},callback(ret, err))
params
param:
- 类型 : JSON
- 描述 : 查询条件
{
theme_id:
- 类型 : LONG
- 描述 : (必填)主题ID
- 默认值 : 无
}
callback(ret, err)
ret:
- 类型:JSON 对象
- 内部字段:
{
total_count:0, // 总数
p_id_list : [] // 数组中返回参数详见下方链接
}
https://open.pinduoduo.com/#/apidocument/port?id=pdd.ddk.theme.goods.search
err:
- 类型:JSON 对象
- 内部字段:
{
errCode: 0 // 错误码,请参照最下方错误code详情地址
errMsg : "" // 请配置正确的clientId 和 secret 及必填参数
}
示例代码
var pinke = api.require('pinke');
pinke.getThemeGoodsSearch({
theme_id : 4647
},function(ret,err){
alert(JSON.stringify(ret));
alert(JSON.stringify(err));
});
getThemePromUrlGenerate
主题活动推广链接生成
getThemePromUrlGenerate({params},callback(ret, err))
params
param:
- 类型 : JSON
- 描述 : 查询条件
{
pid:
- 类型 : STRING
- 描述 : (必填)推广位ID
- 默认值 : 无
theme_id_list:
- 类型 : LONG[]
- 描述 : (必填)主题ID列表,例如[1,235]
- 默认值 : 无
generate_short_url:
- 类型 : BOOLEAN
- 描述 : (可选项)是否生成短链接,true-是,false-否
- 默认值 : false
generate_mobile:
- 类型 : BOOLEAN
- 描述 : (可选项)是否生成手机跳转链接。true-是,false-否
- 默认值 : false
custom_parameters:
- 类型 : STRING
- 描述 : (可选项)自定义参数,为链接打上自定义标签
- 默认值 : 无
generate_weapp_webview:
- 类型 : BOOLEAN
- 描述 : (可选项)是否唤起微信客户端,false 否,true 是
- 默认值 : false
we_app_web_view_short_url:
- 类型 : BOOLEAN
- 描述 : (可选项)唤起微信app推广短链接
- 默认值 : false
we_app_web_wiew_url:
- 类型 : BOOLEAN
- 描述 : (可选项)唤起微信app推广链接
- 默认值 : false
}
callback(ret, err)
ret:
- 类型:JSON 对象
- 内部字段:
{
url_list : [] // 数组中返回参数详见下方链接
}
https://open.pinduoduo.com/#/apidocument/port?id=pdd.ddk.theme.prom.url.generate
err:
- 类型:JSON 对象
- 内部字段:
{
errCode: 0 // 错误码,请参照最下方错误code详情地址
errMsg : "" // 请配置正确的clientId 和 secret 及必填参数
}
示例代码
var pinke = api.require('pinke');
pinke.getThemePromUrlGenerate({
param : {
pid : '8346732_52548325',
theme_id_list : [123]
}
},function(ret,err){
alert(JSON.stringify(ret));
alert(JSON.stringify(err));
});
getDirectGoodsQuery
查询定向推广商品
getDirectGoodsQuery({params},callback(ret, err))
params
param:
- 类型 : JSON
- 描述 : 查询条件
{
page:
- 类型 : INTEGER
- 描述 : (可选项)返回的页数
- 默认值 : 1
page_size:
- 类型 : INTEGER
- 描述 : (可选项)返回的每页推广位数量
- 默认值 : 100
}
callback(ret, err)
ret:
- 类型:JSON 对象
- 内部字段:
{
total_count:0, // 总数
list : [] // 数组中返回参数详见下方链接
}
https://open.pinduoduo.com/#/apidocument/port?id=pdd.ddk.direct.goods.query
err:
- 类型:JSON 对象
- 内部字段:
{
errCode: 0 // 错误码,请参照最下方错误code详情地址
errMsg : "" // 请配置正确的clientId 和 secret 及必填参数
}
示例代码
var pinke = api.require('pinke');
pinke.getDirectGoodsQuery({
param : {
}
},function(ret,err){
alert(JSON.stringify(ret));
alert(JSON.stringify(err));
});
getGoodsZsUnitUrlGen
将其他推广者的推广链接转换为自己的;可以将他人的招商推广链接转换为自己的招商推广链接
getGoodsZsUnitUrlGen({params},callback(ret, err))
params
param:
- 类型 : JSON
- 描述 : 查询条件
{
source_url:
- 类型 : STRING
- 描述 : (必填)需转链的链接
- 默认值 : 无
pid:
- 类型 : STRING
- 描述 : (必填)渠道id
- 默认值 : 1
}
callback(ret, err)
ret:
- 类型:JSON 对象
- 内部字段:
{
// 中返回参数详见下方链接
}
https://open.pinduoduo.com/#/apidocument/port?id=pdd.ddk.goods.zs.unit.url.gen
err:
- 类型:JSON 对象
- 内部字段:
{
errCode: 0 // 错误码,请参照最下方错误code详情地址
errMsg : "" // 请配置正确的clientId 和 secret 及必填参数
}
示例代码
pinke.getGoodsZsUnitUrlGen({
param : {
source_url : '',
pid : ''
}
},function(ret,err){
alert(JSON.stringify(ret));
alert(JSON.stringify(err));
});
getWeappQrcodeUrlGen
生成单品推广小程序二维码Url 此接口如需开通需询问客户,必须有一定的成交量才能开通
getWeappQrcodeUrlGen({params},callback(ret, err))
params
param:
- 类型 : JSON
- 描述 : 查询条件
{
p_id:
- 类型 : STRING
- 描述 : (必填)推广位ID
- 默认值 : 无
goods_id_list:
- 类型 : LONG[]
- 描述 : (必填)商品ID,仅支持单个查询
- 默认值 : 无
custom_parameters:
- 类型 : STRING
- 描述 : (可选项)自定义参数,为链接打上自定义标签
- 默认值 : 无
zs_duo_id:
- 类型 : LONG
- 描述 : (可选项)招商多多客ID
- 默认值 : 无
}
callback(ret, err)
ret:
- 类型:JSON 对象
- 内部字段:
{
url:'', // 单品推广小程序二维码url
}
https://open.pinduoduo.com/#/apidocument/port?id=pdd.ddk.weapp.qrcode.url.gen
err:
- 类型:JSON 对象
- 内部字段:
{
errCode: 0 // 错误码,请参照最下方错误code详情地址
errMsg : "" // 请配置正确的clientId 和 secret 及必填参数
}
示例代码
var pinke = api.require('pinke');
pinke.getWeappQrcodeUrlGen({
param : {
p_id : '8346732_52548325',
goods_id_list : [4435268166]
}
},function(ret,err){
alert(JSON.stringify(ret));
alert(JSON.stringify(err));
});
getGoodsBasicInfo
获取商品基本信息
getGoodsBasicInfo({params},callback(ret, err))
params
param:
- 类型 : JSON
- 描述 : 查询条件
{
goods_id_list:
- 类型 : LONG[]
- 描述 : (必填)商品id
- 默认值 : 无
}
callback(ret, err)
ret:
- 类型:JSON 对象
- 内部字段:
{
goods_list : [] // 数组中返回参数详见下方链接
}
https://open.pinduoduo.com/#/apidocument/port?id=pdd.ddk.goods.basic.info.get
err:
- 类型:JSON 对象
- 内部字段:
{
errCode: 0 // 错误码,请参照最下方错误code详情地址
errMsg : "" // 请配置正确的clientId 和 secret 及必填参数
}
示例代码
var pinke = api.require('pinke');
pinke.getGoodsBasicInfo({
goods_id_list : [4435268166]
},function(ret,err){
alert(JSON.stringify(ret));
alert(JSON.stringify(err));
});
getGoodsRecommend
运营频道商品查询
getGoodsRecommend({params},callback(ret, err))
params
param:
- 类型 : JSON
- 描述 : 查询条件
{
offset:
- 类型 : INTEGER
- 描述 : (可选项)从多少位置开始请求;
- 默认值 : 0
limit:
- 类型 : INTEGER
- 描述 : (可选项)请求数量
- 默认值 : 400
channel_type:
- 类型 : INTEGER
- 描述 : (可选项)频道类型;0, "1.9包邮", 1, "今日爆款", 2, "品牌清仓", 3, "默认商城", 非必填
- 默认值 : 1
pid:
- 类型 : STRING
- 描述 : (可选项)推广位id
- 默认值 : 无
custom_parameters:
- 类型 : STRING
- 描述 : (可选项)自定义参数
- 默认值 : 无
}
callback(ret, err)
ret:
- 类型:JSON 对象
- 内部字段:
{
total:0, // 总数
list : [] // 数组中返回参数详见下方链接
}
https://open.pinduoduo.com/#/apidocument/port?id=pdd.ddk.goods.recommend.get
err:
- 类型:JSON 对象
- 内部字段:
{
errCode: 0 // 错误码,请参照最下方错误code详情地址
errMsg : "" // 请配置正确的clientId 和 secret 及必填参数
}
示例代码
var pinke = api.require('pinke');
pinke.getGoodsRecommend({
param : {
}
},function(ret,err){
alert(JSON.stringify(ret));
alert(JSON.stringify(err));
});
getOrderDetail
查询订单详情
getOrderDetail({params},callback(ret, err))
params
param:
- 类型 : JSON
- 描述 : 查询条件
{
order_sn:
- 类型 : STRING
- 描述 : (必填)订单号
- 默认值 : 无
}
callback(ret, err)
ret:
- 类型:JSON 对象
- 内部字段:
{
// 返回参数详见下方链接
}
https://open.pinduoduo.com/#/apidocument/port?id=pdd.ddk.order.detail.get
err:
- 类型:JSON 对象
- 内部字段:
{
errCode: 0 // 错误码,请参照最下方错误code详情地址
errMsg : "" // 请配置正确的clientId 和 secret 及必填参数
}
示例代码
var pinke = api.require('pinke');
pinke.getOrderDetail({
order_sn : ''
},function(ret,err){
alert(JSON.stringify(ret));
alert(JSON.stringify(err));
});
getMallGoodsList
查询店铺商品
getMallGoodsList({params},callback(ret, err))
params
param:
- 类型 : JSON
- 描述 : 查询条件
{
mall_id:
- 类型 : LONG
- 描述 : (必填)店铺id
- 默认值 : 无
page:
- 类型 : INTEGER
- 描述 : (可选项)返回的页数
- 默认值 : 1
page_size:
- 类型 : INTEGER
- 描述 : (可选项)返回的每页推广位数量
- 默认值 : 100
}
callback(ret, err)
ret:
- 类型:JSON 对象
- 内部字段:
{
total:0, // 总数
goods_list : [] // 数组中返回参数详见下方链接
}
https://open.pinduoduo.com/#/apidocument/port?id=pdd.ddk.mall.goods.list.get
err:
- 类型:JSON 对象
- 内部字段:
{
errCode: 0 // 错误码,请参照最下方错误code详情地址
errMsg : "" // 请配置正确的clientId 和 secret 及必填参数
}
示例代码
var pinke = api.require('pinke');
pinke.getMallGoodsList({
param : {
mall_id : 123 ,
page_number : 1,
page_size:1
}
},function(ret,err){
alert(JSON.stringify(ret));
alert(JSON.stringify(err));
});
getMallUrlGen
生成店铺推广链接
getMallUrlGen({params},callback(ret, err))
params
param:
- 类型 : JSON
- 描述 : 查询条件
{
mall_id:
- 类型 : LONG
- 描述 : (必填)店铺id
- 默认值 : 无
pid:
- 类型 : STRING
- 描述 : (必填)推广位
- 默认值 : 无
generate_weapp_webview:
- 类型 : BOOLEAN
- 描述 : (可选项)是否生成唤起微信客户端链接,true-是,false-否
- 默认值 : false
generate_short_url:
- 类型 : BOOLEAN
- 描述 : (可选项)是否生成短链接
- 默认值 : false
multi_group:
- 类型 : BOOLEAN
- 描述 : (可选项)true--生成多人团推广链接 false--生成单人团推广链接
- 默认值 : false
custom_parameters:
- 类型 : STRING
- 描述 : (可选项)自定义参数,为链接打上自定义标签
- 默认值 : 100
}
callback(ret, err)
ret:
- 类型:JSON 对象
- 内部字段:
{
list : [] // 数组中返回参数详见下方链接
}
https://open.pinduoduo.com/#/apidocument/port?id=pdd.ddk.mall.url.gen
err:
- 类型:JSON 对象
- 内部字段:
{
errCode: 0 // 错误码,请参照最下方错误code详情地址
errMsg : "" // 请配置正确的clientId 和 secret 及必填参数
}
示例代码
var pinke = api.require('pinke');
pinke.getMallUrlGen({
param : {
mall_id : 123,
pid : '8346732_52548325'
}
},function(ret,err){
alert(JSON.stringify(ret));
alert(JSON.stringify(err));
});
getLotteryUrlGen
生成转盘抽免单Url
getLotteryUrlGen({params},callback(ret, err))
此接口设置了权限,需要一定的订单数才可使用,具体请咨询官方客服
params
param:
- 类型 : JSON
- 描述 : 查询条件
{
pid_list:
- 类型 : STRING[]
- 描述 : (必填)推广位
- 默认值 : 无
generate_weapp_webview:
- 类型 : BOOLEAN
- 描述 : (可选项)是否生成唤起微信客户端链接,true-是,false-否
- 默认值 : false
generate_short_url:
- 类型 : STRING
- 描述 : (可选项)是否生成短链接,true-是,false-否
- 默认值 : 无
multi_group:
- 类型 : BOOLEAN
- 描述 : (可选项)true--生成多人团推广链接false--生成单人团推广链接
- 默认值 : false
custom_parameters:
- 类型 : STRING
- 描述 : (可选项)自定义参数,为链接打上自定义标签
- 默认值 : 无
}
callback(ret, err)
ret:
- 类型:JSON 对象
- 内部字段:
{
total:0, // 总数
url_list : [] // 数组中返回参数详见下方链接
}
https://open.pinduoduo.com/#/apidocument/port?id=pdd.ddk.lottery.url.gen
err:
- 类型:JSON 对象
- 内部字段:
{
errCode: 0 // 错误码,请参照最下方错误code详情地址
errMsg : "" // 请配置正确的clientId 和 secret 及必填参数
}
示例代码
var pinke = api.require('pinke');
pinke.getLotteryUrlGen({
param : {
pid_list : ['8346732_52548325']
}
},function(ret,err){
alert(JSON.stringify(ret));
alert(JSON.stringify(err));
});
getLotteryNewList
查询转盘拉新订单
getLotteryNewList({params},callback(ret, err))
params
param:
- 类型 : JSON
- 描述 : 查询条件
{
pid:
- 类型 : STRING
- 描述 : (可选项)推广位ID
- 默认值 : 1
start_time:
- 类型 : LONG
- 描述 : (可选项)最后更新时间--查询时间开始。note:此时间为时间戳
- 默认值 : 无
end_time:
- 类型 : LONG
- 描述 : (可选项)最后更新时间--查询时间结束。
- 默认值 : 无
page_size:
- 类型 : INTEGER
- 描述 : (可选项)返回的每页结果列表数
- 默认值 : 100
page:
- 类型 : INTEGER
- 描述 : (可选项)返回的页数
- 默认值 : 1
customer_paramters:
- 类型 : STRING
- 描述 : (可选项)自定义参数,为链接打上自定义标签
- 默认值 : 无
}
callback(ret, err)
ret:
- 类型:JSON 对象
- 内部字段:
{
page_num:1, // 页数
page_size:100, // 每月数量
total_count:100, // 总数
list : [] // 数组中返回参数详见下方链接
}
https://open.pinduoduo.com/#/apidocument/port?id=pdd.ddk.lottery.new.list.get
err:
- 类型:JSON 对象
- 内部字段:
{
errCode: 0 // 错误码,请参照最下方错误code详情地址
errMsg : "" // 请配置正确的clientId 和 secret 及必填参数
}
示例代码
var pinke = api.require('pinke');
pinke.getLotteryNewList({
param : {
}
},function(ret,err){
alert(JSON.stringify(ret));
alert(JSON.stringify(err));
});
getResourceUrlGen
多多进宝频道推广
getResourceUrlGen({params},callback(ret, err))
params
param:
- 类型 : JSON
- 描述 : 查询条件
{
pid:
- 类型 : STRING
- 描述 : (必填)推广位
- 默认值 : 无
resource_type:
- 类型 : INTEGER
- 描述 : (可选项)频道来源:4-限时秒杀,39997-充值中心, 39998-转链type,39999-电器城
- 默认值 : 无
url:
- 类型 : STRING
- 描述 : (可选项)原链接
- 默认值 : 无
}
callback(ret, err)
ret:
- 类型:JSON 对象
- 内部字段:
{
multi_url_list: {}, // 单人团链接
single_url_list : [] // 多人团链接
}
https://open.pinduoduo.com/#/apidocument/port?id=pdd.ddk.resource.url.gen
err:
- 类型:JSON 对象
- 内部字段:
{
errCode: 0 // 错误码,请参照最下方错误code详情地址
errMsg : "" // 请配置正确的clientId 和 secret 及必填参数
}
示例代码
var pinke = api.require('pinke');
pinke.getResourceUrlGen({
param : {
pid : '8346732_52548325'
}
},function(ret,err){
alert(JSON.stringify(ret));
alert(JSON.stringify(err));
});
getMerchantList
查询店铺列表
getMerchantList({params},callback(ret, err))
params
param:
- 类型 : JSON
- 描述 : 查询条件
{
mall_id_list:
- 类型 : LONG[]
- 描述 : (可选项)店铺id
- 默认值 : 无
merchant_type_list:
- 类型 : INTEGER[]
- 描述 : (可选项)店铺类型
- 默认值 : 无
query_range_str:
- 类型 : INTEGER
- 描述 : (可选项)查询范围0----商品拼团价格区间;1----商品券后价价格区间;2----佣金比例区间;3----优惠券金额区间;4----加入多多进宝时间区间;5----销量区间;6----佣金金额区间
- 默认值 : 无
cat_id:
- 类型 : LONG
- 描述 : (可选项)商品类目ID
- 默认值 : 无
has_coupon:
- 类型 : INTEGER
- 描述 : (可选项)是否有优惠券 (0 所有;1 必须有券。)
- 默认值 : 0
page_number:
- 类型 : INTEGER
- 描述 : (可选项)返回的页数
- 默认值 : 1
page_size:
- 类型 : INTEGER
- 描述 : (可选项)返回的每页数量
- 默认值 : 100
range_vo_list:
- 类型 : STRING
- 描述 : (可选项)筛选范围
- 默认值 : 无
}
callback(ret, err)
ret:
- 类型:JSON 对象
- 内部字段:
{
total:0, // 总数
mall_search_info_vo_list : [] // 数组中返回参数详见下方链接
}
https://open.pinduoduo.com/#/apidocument/port?id=pdd.ddk.merchant.list.get
err:
- 类型:JSON 对象
- 内部字段:
{
errCode: 0 // 错误码,请参照最下方错误code详情地址
errMsg : "" // 请配置正确的clientId 和 secret 及必填参数
}
示例代码
pinke.getMerchantList({
param : {
range_vo_list : 'AJ'
}
},function(ret,err){
alert(JSON.stringify(ret));
alert(JSON.stringify(err));
});
getTopGoodsList
获取爆款排行商品
getTopGoodsList({params},callback(ret, err))
params
param:
- 类型 : JSON
- 描述 : 查询条件
{
p_id:
- 类型 : STRING
- 描述 : (可选项)推广位id
- 默认值 : 无
offset:
- 类型 : INTEGER
- 描述 : (可选项)从多少位置开始请求;
- 默认值 : 0
sort_type:
- 类型 : INTEGER
- 描述 : (可选项)1-实时热销榜;2-实时收益榜
- 默认值 : 1
limit:
- 类型 : INTEGER
- 描述 : (可选项)请求数量
- 默认值 : 400
}
callback(ret, err)
ret:
- 类型:JSON 对象
- 内部字段:
{
total:0, // 总数
list : [] // 数组中返回参数详见下方链接
}
https://open.pinduoduo.com/#/apidocument/port?id=pdd.ddk.top.goods.list.query
err:
- 类型:JSON 对象
- 内部字段:
{
errCode: 0 // 错误码,请参照最下方错误code详情地址
errMsg : "" // 请配置正确的clientId 和 secret 及必填参数
}
示例代码
var pinke = api.require('pinke');
pinke.getTopGoodsList({
param : {
}
},function(ret,err){
alert(JSON.stringify(ret));
alert(JSON.stringify(err));
});
其他
因为多多客开放平台开放时间不长,很多地方官方还未完善,如出现问题或未及时更新,请在群众交流,QQ群号码在最下方。
\==申请流程==
1.注册登录多多进宝网站:jinbao.pinduoduo.com
2.选择API权限-申请-等待审核
3.审核通过在API权限下会显示账户的ClientID,点击按钮- 前往查看API文档(跳转的是拼多多开放平台https://open.pinduoduo.com/#/apidocument)
4.同样注册申请,需要上传开发者的身份证信息,如果是企业开发者需要上传营业执照等信息,等待审核。
5.审核通过在上方菜单栏-控制台-我的应用-创建应用-选择多多客联盟
6.填写应用基本信息-包括mrd文档与prd文档(有模版,按照模版写就可以,现在不用写的特别全面,基本都会审核通过)
7.回调地址指的是当有回调事件方式时,回传的地址(如果你没有服务端,就需要去申请一个免费的建站,我之前是在凡客注册的一个,是免费的)
8.官方地址(同上)
9.提交审核
10.审核成功后在控制台-我的应用下会看到创建的应用,查看详情,里面有应用的相关信息包括相关的key信息。
11.如果有其他问题可以加入QQ 群讨论,请务必标名是通过apicloud,群号码:738256791
可用性
Android系统
可提供的1.0.0及更高版本