pinke

来自于:开发者立即使用

模块概述

本模块实封装了多多客开放接口,针对多多进宝的商品,推荐导购并赚取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及更高版本