pinke

init getAllOrderListIncrement getGoodsSearch getPidGenerate getOrderListIncrement getRpPromUrlGenerate getThemeList getThemePromUrlGenerate getGoodsZsUnitUrlGen getGoodsBasicInfo getOrderDetail getMallUrlGen getLotteryNewList getMerchantList

模块概述

本模块实封装了多多客开放接口，针对多多进宝的商品，推荐导购并赚取CPS佣金。用户需到多多进宝网站申请，具体流程见文档底部。

针对多多联盟类应用的接口封装，可直接调用接口，使用此模版需调用init（）方法初始化（初始化一次即可）。

配置： 需在config文件下配置key相关信息（申请流程见底部）。

目前暂只支持安卓，后期将追加ios相关支持。

init

初始化模块

init()

params

callback(ret, err)

示例代码

  2. pinke.init();

getCats(

查询类目信息

getCats({params},callback(ret, err))

params

cartId :

  • 类型：long
  • 描述：（必填项）查询类目的父节点id，根节点为0
  • 默认值：0

callback(ret, err)

ret：

  • 类型：JSON 对象
  • 内部字段：
  1. {
  2.     data: 
  3.         {
  4.             goods_cats_list:[{
  5.                 cat_id : 69,     // 类目ID
  6.                 cat_name : 美容护肤/精油, // 类目名称
  7.                 level : 1,  // 类目级别
  8.                 parent_cat_id   // 所属父类目id
  9.             }]    
  10.         }
  11. }

err：

  • 类型：JSON 对象
  • 内部字段：
  1. { 
  2.     errCode: 0       // 错误码，请参照最下方错误code详情地址
  3.     errMsg : ""      // 请配置正确的clientId 和 secret 及必填参数
  4. }

示例代码

  1. var pinke = api.require('pinke');
  2. pinke.getCats({catId,0},function(ret,err){
  3.     alert(JSON.stringify(ret));
  4.     alert(JSON.stringify(err));
  5. });

getAllOrderListIncrement

查询订单列表

getAllOrderListIncrement({params},callback(ret, err))

（此接口已过时，请使用getOrderListIncrement）

params

param:

  • 类型 ： JSON
  • 描述 ： 查询条件

{

  1. start_update_time:
  2. - 类型 ： LONG 
  3. - 描述 ： （必填）最近90天内多多进宝商品订单更新时间--查询时间开始。
  4. time为unix时间戳。
  5. - 默认值 ： 无
  7. end_update_time:
  8. - 类型 ： LONG 
  9. - 描述 ： （必填）查询结束时间，和开始时间相差不能超过24小时。
  10. - 默认值 ： 无
  12. page_size:
  13. - 类型 ： INTEGER
  14. - 描述 ： 返回的每页结果订单数
  15. - 默认值：100
  17. page:
  18. - 类型 ： INTEGER
  19. - 描述 ： 页数
  20. - 默认值：1
  22. return_count:
  23. - 类型 ： BOOLEAN
  24. - 描述 ： 是否返回总数
  25. - 默认值：true

}

callback(ret, err)

ret：

  • 类型：JSON 对象
  • 内部字段：
  1. {
  2.     total_count: 0        // LONG；true，请求到的结果数
  3.     order_list : []       // 数组返回参数详见下方链接
  4. }

https://open.pinduoduo.com/#/apidocument/port?id=pdd.ddk.order.list.increment.get

err：

  • 类型：JSON 对象
  • 内部字段：
  1. { 
  2.     errCode: 0       // 错误码，请参照最下方错误code详情地址
  3.     errMsg : ""      // 请配置正确的clientId 和 secret 及必填参数
  4. }

示例代码

  1.             var pinke = api.require('pinke');
  2.             pinke.getAllOrderListIncrement({
  3.                 param : {
  4.                         start_update_time:1523457600,
  5.                         end_update_time:1555343999
  6.                 }
  7.             },function(ret,err){
  8.                 alert(JSON.stringify(ret));
  9.                 alert(JSON.stringify(err));
  10.             });

getGoodsDetail

查询商品详情

getGoodsDetail({params},callback(ret, err))

params

param:

  • 类型 ： JSON
  • 描述 ： 查询条件

{

  1. goods_id_list:
  2. - 类型 ： LONG[]
  3. - 描述 ： （必填）商品ID，仅支持单个查询。例如：[123456]
  4. - 默认值 ： 无
  6. pid:
  7. - 类型 ： STRING
  8. - 描述 ： （可选项）推广位id
  9. - 默认值 ： 无
  11. custom_parameters:
  12. - 类型 ： STRING
  13. - 描述 ： （可选项）自定义参数
  14. - 默认值 ： 无
  16. zs_duo_id:
  17. - 类型 ： LONG
  18. - 描述 ： （可选项）招商多多客ID
  19. - 默认值 ： 无
  21. plan_type:
  22. - 类型 ： INTEGER
  23. - 描述 ： （可选项）佣金优惠券对应推广类型，3：专属 4：招商
  24. - 默认值 ： 无

}

callback(ret, err)

ret：

  • 类型：JSON 对象
  • 内部字段：
  1. {
  2.     goods_details : []       // 数组返回参数详见下方链接
  3. }

err：

  • 类型：JSON 对象
  • 内部字段：
  1. { 
  2.     errCode: 0       // 错误码，请参照最下方错误code详情地址
  3.     errMsg : ""      // 请配置正确的clientId 和 secret 及必填参数
  4. }

示例代码

  1.             var pinke = api.require('pinke');
  2.             pinke.getGoodsDetail({
  3.                 param : {
  4.                     goods_id_list: [4435268166]
  5.                 }
  6.             },function(ret,err){
  7.                 alert(JSON.stringify(ret));
  8.                 alert(JSON.stringify(err));
  9.             });

getGoodsSearch

商品搜索

getGoodsSearch({params},callback(ret, err))

params

param:

  • 类型 ： JSON
  • 描述 ： 查询条件

{

  1. keyword:
  2. - 类型 ： STRING
  3. - 描述 ： （可选项）商品关键词，与opt_id字段选填一个或全部填写
  4. - 默认值 ： 无
  6. opt_id:
  7. - 类型 ： LONG
  8. - 描述 ： （可选项）商品标签类目ID
  9. - 默认值 ： 无
  11. page:
  12. - 类型 ： INTEGER
  13. - 描述 ： （可选项）商品分页数
  14. - 默认值 ： 1
  16. page_size:
  17. - 类型 ： INTEGER
  18. - 描述 ： （可选项）每页商品数量
  19. - 默认值 ： 100
  21. sort_type:
  22. - 类型 ： INTEGER
  23. - 描述 ： （可选项）排序方式：0-31 可至下方此接口链接处查询
  24. - 默认值 ： 0
  26. with_coupon:
  27. - 类型 ： BOOLEAN
  28. - 描述 ： （可选项）是否只返回优惠券的商品
  29. - 默认值 ： false
  31. range_list:
  32. - 类型 ： INTEGER
  33. - 描述 ： （可选项）筛选范围:[{"range_id":0,"range_from":1,"range_to":1500},{"range_id":1,"range_from":1,"range_to":1500}]
  34. - 默认值 ： 无
  36. cat_id:
  37. - 类型 ： LONG
  38. - 描述 ： （可选项）商品类目ID
  39. - 默认值 ： 无
  41. goods_id_list:
  42. - 类型 ： LONG[]
  43. - 描述 ： （可选项）商品ID列表。例如：[123456,123]
  44. - 默认值 ： 无
  46. merchant_type:
  47. - 类型 ： LONG[]
  48. - 描述 ： （可选项）商品ID列表。例如：[123456,123]
  49. - 默认值 ： 无
  51. pid:
  52. - 类型 ： STRING
  53. - 描述 ： （可选项）推广位id
  54. - 默认值 ： 无
  56. custom_parameters:
  57. - 类型 ： STRING
  58. - 描述 ： （可选项）自定义参数
  59. - 默认值 ： 无

}

callback(ret, err)

ret：

  • 类型：JSON 对象
  • 内部字段：
  1. {
  2.     goods_list : []       // 数组中返回参数详见下方链接
  3. }

https://open.pinduoduo.com/#/apidocument/port?id=pdd.ddk.goods.search

err：

  • 类型：JSON 对象
  • 内部字段：
  1. { 
  2.     errCode: 0       // 错误码，请参照最下方错误code详情地址
  3.     errMsg : ""      // 请配置正确的clientId 和 secret 及必填参数
  4. }

示例代码

  1.             var pinke = api.require('pinke');
  2.             pinke.getGoodsSearch({
  3.                 param : {
  4.                     keyword:'耐克'
  5.                 }
  6.             },function(ret,err){
  7.                 alert(JSON.stringify(ret));
  8.                 alert(JSON.stringify(err));
  9.             });

goodsPidQuery

查询多多进宝推广位

goodsPidQuery({params},callback(ret, err))

params

param:

  • 类型 ： JSON
  • 描述 ： 查询条件

{

  1. page:
  2. - 类型 ： INTEGER
  3. - 描述 ： （可选项）返回的页数
  4. - 默认值 ： 1
  6. page_size:
  7. - 类型 ： INTEGER
  8. - 描述 ： （可选项）返回的每页推广位数量
  9. - 默认值 ： 100

}

callback(ret, err)

ret：

  • 类型：JSON 对象
  • 内部字段：
  1. {
  2.     total_count:0, // 总数
  3.     p_id_list : []       // 数组中返回参数详见下方链接
  4. }

err：

  • 类型：JSON 对象
  • 内部字段：
  1. { 
  2.     errCode: 0       // 错误码，请参照最下方错误code详情地址
  3.     errMsg : ""      // 请配置正确的clientId 和 secret 及必填参数
  4. }

示例代码

  1.             var pinke = api.require('pinke');
  2.             pinke.goodsPidQuery({
  3.                 param : {
  5.                 }
  6.             },function(ret,err){
  7.                 alert(JSON.stringify(ret));
  8.                 alert(JSON.stringify(err));
  9.             });

getPidGenerate

创建多多进宝推广位

getPidGenerate({params},callback(ret, err))

params

param:

  • 类型 ： JSON
  • 描述 ： 查询条件

{

  1. number:
  2. - 类型 ： LONG
  3. - 描述 ： （必填项）要生成的推广位数量
  4. - 默认值 ： 无
  6. p_id_name_list:
  7. - 类型 ： STRING[]
  8. - 描述 ： （可选项）推广位名称
  9. - 默认值 ： 无

}

callback(ret, err)

ret：

  • 类型：JSON 对象
  • 内部字段：
  1. {
  2.     p_id_list : []       // 数组中返回参数详见下方链接
  3. }

https://open.pinduoduo.com/#/apidocument/port?id=pdd.ddk.goods.pid.generatey

err：

  • 类型：JSON 对象
  • 内部字段：
  1. { 
  2.     errCode: 0       // 错误码，请参照最下方错误code详情地址
  3.     errMsg : ""      // 请配置正确的clientId 和 secret 及必填参数
  4. }

示例代码

  1.             var pinke = api.require('pinke');
  2.             pinke.getPidGenerate({
  3.                 param : {
  4.                     number : 1,
  5.                     p_id_name_list : ['测试推广位']
  6.                 }
  7.             },function(ret,err){
  8.                 alert(JSON.stringify(ret));
  9.                 alert(JSON.stringify(err));
  10.             });

getGoodsPromotionUrlGenerate

生成普通商品推广链接

getGoodsPromotionUrlGenerate({params},callback(ret, err))

params

param:

  • 类型 ： JSON
  • 描述 ： 查询条件

{

  1. p_id:
  2. - 类型 ： STRING
  3. - 描述 ： （必填）推广位ID
  4. - 默认值 ： 无
  6. goods_id_list:
  7. - 类型 ： LONG[]
  8. - 描述 ： （必填）商品ID，仅支持单个查询
  9. - 默认值 ： 无
  11. generate_short_url:
  12. - 类型 ： BOOLEAN
  13. - 描述 ： （可选项）是否生成短链接
  14. - 默认值 ： false
  16. multi_group:
  17. - 类型 ： BOOLEAN
  18. - 描述 ： （可选项）true--生成多人团推广链接 false--生成单人团推广链接
  19. - 默认值 ： false
  21. custom_parameters:
  22. - 类型 ： STRING
  23. - 描述 ： （可选项）自定义参数
  24. - 默认值 ： 100
  26. generate_weapp_webview:
  27. - 类型 ： BOOLEAN
  28. - 描述 ： （可选项）是否生成唤起微信客户端链接
  29. - 默认值 ： false
  31. zs_duo_id:
  32. - 类型 ： LONG
  33. - 描述 ： （可选项）招商多多客ID
  34. - 默认值 ： 无
  36. generate_we_app:
  37. - 类型 ： BOOLEAN
  38. - 默认值 ： false

}

callback(ret, err)

ret：

  • 类型：JSON 对象
  • 内部字段：
  1. {
  2.     goods_promotion_url_list : []       // 数组中返回参数详见下方链接
  3. }

err：

  • 类型：JSON 对象
  • 内部字段：
  1. { 
  2.     errCode: 0       // 错误码，请参照最下方错误code详情地址
  3.     errMsg : ""      // 请配置正确的clientId 和 secret 及必填参数
  4. }

示例代码

  1.             var pinke = api.require('pinke');
  2.             pinke.getGoodsPromotionUrlGenerate({
  3.                 param : {
  4.                     p_id : '8346732_52548325',
  5.                     goods_id_list : [4435268166]
  6.                 }
  7.             },function(ret,err){
  8.                 alert(JSON.stringify(ret));
  9.                 alert(JSON.stringify(err));
  10.             });

getOrderListIncrement

最后更新时间段增量同步推广订单信息

getOrderListIncrement({params},callback(ret, err))

params

param:

  • 类型 ： JSON
  • 描述 ： 查询条件

{

  1. start_update_time:
  2. - 类型 ： LONG 
  3. - 描述 ： （必填）最近90天内多多进宝商品订单更新时间--查询时间开始。
  4. time为unix时间戳。
  5. - 默认值 ： 无
  7. end_update_time:
  8. - 类型 ： LONG 
  9. - 描述 ： （必填）查询结束时间，和开始时间相差不能超过24小时。
  10. - 默认值 ： 无
  12. page_size:
  13. - 类型 ： INTEGER
  14. - 描述 ： 返回的每页结果订单数
  15. - 默认值：100
  17. page:
  18. - 类型 ： INTEGER
  19. - 描述 ： 页数
  20. - 默认值：1
  22. return_count:
  23. - 类型 ： BOOLEAN
  24. - 描述 ： 是否返回总数
  25. - 默认值：true

}

callback(ret, err)

ret：

  • 类型：JSON 对象
  • 内部字段：
  1. {
  2.     total_count:0, // 总数
  3.     order_list : []       // 数组中返回参数详见下方链接
  4. }

https://open.pinduoduo.com/#/apidocument/port?id=pdd.ddk.order.list.increment.get

err：

  • 类型：JSON 对象
  • 内部字段：
  1. { 
  2.     errCode: 0       // 错误码，请参照最下方错误code详情地址
  3.     errMsg : ""      // 请配置正确的clientId 和 secret 及必填参数
  4. }

示例代码

  1.             pinke.getOrderListIncrement({
  2.                 param : {
  3.                         start_update_time:1523457600,
  4.                         end_update_time:1555343999
  5.                 }
  6.             },function(ret,err){
  7.                 alert(JSON.stringify(ret));
  8.                 alert(JSON.stringify(err));
  9.             });

getGoodsOpt

获得商品便签列表

getGoodsOpt({params},callback(ret, err))

param:

  • 类型 ： JSON
  • 描述 ： 查询条件

{

  1. parent_opt_id:
  2. - 类型 ： INTEGER
  4. - 默认值 ： 无

}

callback(ret, err)

ret：

  • 类型：JSON 对象
  • 内部字段：
  1. {
  2.     goods_opt_list : []       // 数组中返回参数详见下方链接
  3. }

err：

  • 类型：JSON 对象
  • 内部字段：
  1. { 
  2.     errCode: 0       // 错误码，请参照最下方错误code详情地址
  3.     errMsg : ""      // 请配置正确的clientId 和 secret 及必填参数
  4. }

示例代码

getRpPromUrlGenerate

getRpPromUrlGenerate({params},callback(ret, err))

params

param:

  • 类型 ： JSON
  • 描述 ： 查询条件

{

  1. generate_short_url:
  2. - 类型 ： BOOLEAN
  3. - 描述 ： （可选项）是否生成短链接。true-是，false-否
  4. - 默认值 ： false
  6. p_id_list:
  7. - 类型 ： STRING[]
  8. - 描述 ： （必填）推广位列表，例如：["60005_612"]
  9. - 默认值 ： 无
  11. custom_parameters:
  12. - 类型 ： STRING
  13. - 描述 ： （可选项）自定义参数，为链接打上自定义标签
  14. - 默认值 ： 无
  16. generate_weapp_webview:
  17. - 类型 ： BOOLEAN
  18. - 描述 ： （必填）是否唤起微信客户端
  19. - 默认值 ： false
  21. we_app_web_view_short_url:
  22. - 类型 ： BOOLEAN
  23. - 描述 ： （可选项）唤起微信app推广短链接
  24. - 默认值 ： 无
  26. p_id_list:
  27. - 类型 ： BOOLEAN
  28. - 描述 ： （可选项）唤起微信app推广链接
  29. - 默认值 ： 无
  31. p_id_list:
  32. - 类型 ： BOOLEAN
  33. - 描述 ： （可选项）是否生成小程序推广
  34. - 默认值 ： 无

}

callback(ret, err)

ret：

  • 类型：JSON 对象
  • 内部字段：
  1. {
  2.     url_list : []       // 数组中返回参数详见下方链接
  3. }

https://open.pinduoduo.com/#/apidocument/port?id=pdd.ddk.rp.prom.url.generate

err：

  • 类型：JSON 对象
  • 内部字段：
  1. { 
  2.     errCode: 0       // 错误码，请参照最下方错误code详情地址
  3.     errMsg : ""      // 请配置正确的clientId 和 secret 及必填参数
  4. }

示例代码

  1.             var pinke = api.require('pinke');
  2.             pinke.getRpPromUrlGenerate({
  3.                 param : {
  4.                     p_id_list : ['8346732_52548325'],
  5.                     generate_weapp_webview : true
  6.                 }
  7.             },function(ret,err){
  8.                 alert(JSON.stringify(ret));
  9.                 alert(JSON.stringify(err));
  10.             });

getCmsPromUrlGenerate

生成商城推广链接

getCmsPromUrlGenerate({params},callback(ret, err))

params

param:

  • 类型 ： JSON
  • 描述 ： 查询条件

{

  1. we_app_web_view_short_url:
  2. - 类型 ： BOOLEAN
  3. - 描述 ： （必填）唤起微信app推广短链接
  4. - 默认值 ： 无 
  6. we_app_web_view_url:
  7. - 类型 ： BOOLEAN
  8. - 描述 ： （必填）唤起微信app推广链接
  9. - 默认值 ： 无
  11. generate_short_url:
  12. - 类型 ： BOOLEAN
  13. - 描述 ： （可选项）是否生成短链接量
  14. - 默认值 ： false
  16. generate_mobile:
  17. - 类型 ： BOOLEAN
  18. - 描述 ： （可选项）是否生成手机跳转链接
  19. - 默认值 ： false
  21. multi_group:
  22. - 类型 ： BOOLEAN
  23. - 描述 ： （可选项）单人团多人团标志。true-多人团，false-单人团
  24. - 默认值 ： false
  26. custom_parameters:
  27. - 类型 ： LONG
  28. - 描述 ： （可选项）返回的每页推广位数量
  29. - 默认值 ： 无
  31. generate_weapp_webview:
  32. - 类型 ： BOOLEAN
  33. - 描述 ： （可选项）是否唤起微信客户端， 默认false 否，true 是
  34. - 默认值 ： false
  36. channel_type:
  37. - 类型 ： INTEGER
  38. - 描述 ： （可选项）0, "1.9包邮"；1, "今日爆款"； 2, "品牌清仓"； 4,"PC端专属商城"；5, "养宝宝兑现金"；不传值为默认商城
  39. - 默认值 ： 无
  41. p_id_list:
  42. - 类型 ： STRING[]
  43. - 描述 ： （可选项）推广位列表，例如：["60005_612"]
  44. - 默认值 ： 无

}

callback(ret, err)

ret：

  • 类型：JSON 对象
  • 内部字段：
  1. {
  2.     total:0, // 总数
  3.     url_list : []       // 数组中返回参数详见下方链接
  4. }

err：

  • 类型：JSON 对象
  • 内部字段：
  1. { 
  2.     errCode: 0       // 错误码，请参照最下方错误code详情地址
  3.     errMsg : ""      // 请配置正确的clientId 和 secret 及必填参数
  4. }

示例代码

  1.             var pinke = api.require('pinke');
  2.             pinke.getCmsPromUrlGenerate({
  3.                 param : {
  4.                     p_id_list : ["8346732_52548325"],
  5.                     generate_short_url : true,
  6.                     generate_mobile : true,
  7.                     channel_type : 1 ,
  8.                     we_app_web_view_url : true,
  9.                     we_app_web_view_short_url : true
  10.                 }
  11.             },function(ret,err){
  12.                 alert(JSON.stringify(ret));
  13.                 alert(JSON.stringify(err));
  14.             });

getThemeList

查询多多进宝主题列表

getThemeList({params},callback(ret, err))

params

param:

  • 类型 ： JSON
  • 描述 ： 查询条件

{

  1. page:
  2. - 类型 ： INTEGER
  3. - 描述 ： （可选项）返回的页数
  4. - 默认值 ： 1
  6. page_size:
  7. - 类型 ： INTEGER
  8. - 描述 ： （可选项）返回的每页推广位数量
  9. - 默认值 ： 100

}

callback(ret, err)

ret：

  • 类型：JSON 对象
  • 内部字段：
  1. {
  2.     total:0, // 总数
  3.     theme_list : []       // 数组中返回参数详见下方链接
  4. }

https://open.pinduoduo.com/#/apidocument/port?id=pdd.ddk.theme.list.get

err：

  • 类型：JSON 对象
  • 内部字段：
  1. { 
  2.     errCode: 0       // 错误码，请参照最下方错误code详情地址
  3.     errMsg : ""      // 请配置正确的clientId 和 secret 及必填参数
  4. }

示例代码

  1.             var pinke = api.require('pinke');
  2.             pinke.getThemeList({
  3.                 param : {
  5.                 }
  6.             },function(ret,err){
  7.                 alert(JSON.stringify(ret));
  8.                 alert(JSON.stringify(err));
  9.             });

getThemeGoodsSearch

多多进宝主题商品查询

getThemeGoodsSearch({params},callback(ret, err))

params

param:

  • 类型 ： JSON
  • 描述 ： 查询条件

{

  1. theme_id:
  2. - 类型 ： LONG
  3. - 描述 ： （必填）主题ID
  4. - 默认值 ： 无

}

callback(ret, err)

ret：

  • 类型：JSON 对象
  • 内部字段：
  1. {
  2.     total_count:0, // 总数
  3.     p_id_list : []       // 数组中返回参数详见下方链接
  4. }

err：

  • 类型：JSON 对象
  • 内部字段：
  1. { 
  2.     errCode: 0       // 错误码，请参照最下方错误code详情地址
  3.     errMsg : ""      // 请配置正确的clientId 和 secret 及必填参数
  4. }

示例代码

  1.             var pinke = api.require('pinke');
  2.             pinke.getThemeGoodsSearch({
  3.                 theme_id : 4647
  4.             },function(ret,err){
  5.                 alert(JSON.stringify(ret));
  6.                 alert(JSON.stringify(err));
  7.             });

getThemePromUrlGenerate

主题活动推广链接生成

getThemePromUrlGenerate({params},callback(ret, err))

params

param:

  • 类型 ： JSON
  • 描述 ： 查询条件

{

  1. pid:
  2. - 类型 ： STRING
  3. - 描述 ： （必填）推广位ID
  4. - 默认值 ： 无
  6. theme_id_list:
  7. - 类型 ： LONG[]
  8. - 描述 ： （必填）主题ID列表,例如[1,235]
  9. - 默认值 ： 无
  11. generate_short_url:
  12. - 类型 ： BOOLEAN
  13. - 描述 ： （可选项）是否生成短链接,true-是,false-否
  14. - 默认值 ： false
  16. generate_mobile:
  17. - 类型 ： BOOLEAN
  18. - 描述 ： （可选项）是否生成手机跳转链接。true-是,false-否
  19. - 默认值 ： false
  21. custom_parameters:
  22. - 类型 ： STRING
  23. - 描述 ： （可选项）自定义参数,为链接打上自定义标签
  24. - 默认值 ： 无
  26. generate_weapp_webview:
  27. - 类型 ： BOOLEAN
  28. - 描述 ： （可选项）是否唤起微信客户端，false 否，true 是
  29. - 默认值 ： false
  31. we_app_web_view_short_url:
  32. - 类型 ： BOOLEAN
  33. - 描述 ： （可选项）唤起微信app推广短链接
  34. - 默认值 ： false
  36. we_app_web_wiew_url:
  37. - 类型 ： BOOLEAN
  38. - 描述 ： （可选项）唤起微信app推广链接
  39. - 默认值 ： false

}

callback(ret, err)

ret：

  • 类型：JSON 对象
  • 内部字段：
  1. {
  2.     url_list : []       // 数组中返回参数详见下方链接
  3. }

https://open.pinduoduo.com/#/apidocument/port?id=pdd.ddk.theme.prom.url.generate

err：

  • 类型：JSON 对象
  • 内部字段：
  1. { 
  2.     errCode: 0       // 错误码，请参照最下方错误code详情地址
  3.     errMsg : ""      // 请配置正确的clientId 和 secret 及必填参数
  4. }

示例代码

  1.             var pinke = api.require('pinke');
  2.             pinke.getThemePromUrlGenerate({
  3.                 param : {
  4.                     pid : '8346732_52548325',
  5.                     theme_id_list : [123]
  6.                 }
  7.             },function(ret,err){
  8.                 alert(JSON.stringify(ret));
  9.                 alert(JSON.stringify(err));
  10.             });

getDirectGoodsQuery

查询定向推广商品

getDirectGoodsQuery({params},callback(ret, err))

params

param:

  • 类型 ： JSON
  • 描述 ： 查询条件

{

  1. page:
  2. - 类型 ： INTEGER
  3. - 描述 ： （可选项）返回的页数
  4. - 默认值 ： 1
  6. page_size:
  7. - 类型 ： INTEGER
  8. - 描述 ： （可选项）返回的每页推广位数量
  9. - 默认值 ： 100

}

callback(ret, err)

ret：

  • 类型：JSON 对象
  • 内部字段：
  1. {
  2.     total_count:0, // 总数
  3.     list : []       // 数组中返回参数详见下方链接
  4. }

err：

  • 类型：JSON 对象
  • 内部字段：
  1. { 
  2.     errCode: 0       // 错误码，请参照最下方错误code详情地址
  3.     errMsg : ""      // 请配置正确的clientId 和 secret 及必填参数
  4. }

示例代码

  1.             var pinke = api.require('pinke');
  2.             pinke.getDirectGoodsQuery({
  3.                 param : {
  5.                 }
  6.             },function(ret,err){
  7.                 alert(JSON.stringify(ret));
  8.                 alert(JSON.stringify(err));
  9.             });

getGoodsZsUnitUrlGen

将其他推广者的推广链接转换为自己的；可以将他人的招商推广链接转换为自己的招商推广链接

getGoodsZsUnitUrlGen({params},callback(ret, err))

params

param:

  • 类型 ： JSON
  • 描述 ： 查询条件

{

  1. source_url:
  2. - 类型 ： STRING
  3. - 描述 ： （必填）需转链的链接
  4. - 默认值 ： 无
  6. pid:
  7. - 类型 ： STRING
  8. - 描述 ： （必填）渠道id
  9. - 默认值 ： 1

}

callback(ret, err)

ret：

  • 类型：JSON 对象
  • 内部字段：
  1. {
  2.     // 中返回参数详见下方链接
  3. }

https://open.pinduoduo.com/#/apidocument/port?id=pdd.ddk.goods.zs.unit.url.gen

err：

  • 类型：JSON 对象
  • 内部字段：
  1. { 
  2.     errCode: 0       // 错误码，请参照最下方错误code详情地址
  3.     errMsg : ""      // 请配置正确的clientId 和 secret 及必填参数
  4. }

示例代码

  1.             pinke.getGoodsZsUnitUrlGen({
  2.                 param : {
  3.                     source_url : '',
  4.                     pid : ''
  5.                 }
  6.             },function(ret,err){
  7.                 alert(JSON.stringify(ret));
  8.                 alert(JSON.stringify(err));
  9.             });

getWeappQrcodeUrlGen

生成单品推广小程序二维码Url 此接口如需开通需询问客户，必须有一定的成交量才能开通

getWeappQrcodeUrlGen({params},callback(ret, err))

params

param:

  • 类型 ： JSON
  • 描述 ： 查询条件

{

  1. p_id:
  2. - 类型 ： STRING
  3. - 描述 ： （必填）推广位ID
  4. - 默认值 ： 无
  6. goods_id_list:
  7. - 类型 ： LONG[]
  8. - 描述 ： （必填）商品ID，仅支持单个查询
  9. - 默认值 ： 无
  11. custom_parameters:
  12. - 类型 ： STRING
  13. - 描述 ： （可选项）自定义参数，为链接打上自定义标签
  14. - 默认值 ： 无
  16. zs_duo_id:
  17. - 类型 ： LONG
  18. - 描述 ： （可选项）招商多多客ID
  19. - 默认值 ： 无

}

callback(ret, err)

ret：

  • 类型：JSON 对象
  • 内部字段：
  1. {
  2.     url:'', // 单品推广小程序二维码url
  3. }

err：

  • 内部字段：
  1. { 
  2.     errCode: 0       // 错误码，请参照最下方错误code详情地址
  3.     errMsg : ""      // 请配置正确的clientId 和 secret 及必填参数
  4. }

示例代码

  1.             var pinke = api.require('pinke');
  2.             pinke.getWeappQrcodeUrlGen({
  3.                 param : {
  4.                     p_id : '8346732_52548325',
  5.                     goods_id_list : [4435268166]
  6.                 }
  7.             },function(ret,err){
  8.                 alert(JSON.stringify(ret));
  9.                 alert(JSON.stringify(err));
  10.             });

getGoodsBasicInfo

获取商品基本信息

getGoodsBasicInfo({params},callback(ret, err))

params

param:

  • 类型 ： JSON
  • 描述 ： 查询条件

{

  1. goods_id_list:
  2. - 类型 ： LONG[]
  3. - 描述 ： （必填）商品id
  4. - 默认值 ： 无

}

ret：

  • 类型：JSON 对象
  • 内部字段：
  1. {
  2.     goods_list : []       // 数组中返回参数详见下方链接
  3. }

https://open.pinduoduo.com/#/apidocument/port?id=pdd.ddk.goods.basic.info.get

err：

  • 类型：JSON 对象
  • 内部字段：
  1. { 
  2.     errCode: 0       // 错误码，请参照最下方错误code详情地址
  3.     errMsg : ""      // 请配置正确的clientId 和 secret 及必填参数
  4. }

示例代码

getGoodsRecommend

运营频道商品查询

getGoodsRecommend({params},callback(ret, err))

params

param:

  • 类型 ： JSON
  • 描述 ： 查询条件

{

  1. offset:
  2. - 类型 ： INTEGER
  3. - 描述 ： （可选项）从多少位置开始请求；
  4. - 默认值 ： 0
  6. limit:
  7. - 类型 ： INTEGER
  9. - 默认值 ： 400
  11. channel_type:
  12. - 类型 ： INTEGER
  13. - 描述 ： （可选项）频道类型；0, "1.9包邮", 1, "今日爆款", 2, "品牌清仓", 3, "默认商城", 非必填 
  14. - 默认值 ： 1
  16. pid:
  17. - 类型 ： STRING
  18. - 描述 ： （可选项）推广位id
  19. - 默认值 ： 无
  21. custom_parameters:
  22. - 类型 ： STRING
  23. - 描述 ： （可选项）自定义参数
  24. - 默认值 ： 无

}

callback(ret, err)

ret：

  • 类型：JSON 对象
  • 内部字段：
  1. {
  2.     total:0, // 总数
  3.     list : []       // 数组中返回参数详见下方链接
  4. }

  • 类型：JSON 对象
  • 内部字段：
  1. { 
  2.     errCode: 0       // 错误码，请参照最下方错误code详情地址
  3.     errMsg : ""      // 请配置正确的clientId 和 secret 及必填参数
  4. }

示例代码

  1.             var pinke = api.require('pinke');
  2.             pinke.getGoodsRecommend({
  3.                 param : {
  5.                 }
  6.             },function(ret,err){
  7.                 alert(JSON.stringify(ret));
  8.                 alert(JSON.stringify(err));
  9.             });

getOrderDetail

查询订单详情

getOrderDetail({params},callback(ret, err))

params

param:

  • 类型 ： JSON
  • 描述 ： 查询条件

{

  1. order_sn:
  2. - 类型 ： STRING
  3. - 描述 ： （必填）订单号
  4. - 默认值 ： 无

}

callback(ret, err)

ret：

  • 类型：JSON 对象
  • 内部字段：
  1. {
  2.     // 返回参数详见下方链接
  3. }

https://open.pinduoduo.com/#/apidocument/port?id=pdd.ddk.order.detail.get

err：

  • 类型：JSON 对象
  • 内部字段：
  1. { 
  2.     errCode: 0       // 错误码，请参照最下方错误code详情地址
  3.     errMsg : ""      // 请配置正确的clientId 和 secret 及必填参数
  4. }

示例代码

  1.             var pinke = api.require('pinke');
  2.             pinke.getOrderDetail({
  3.                 order_sn : ''
  4.             },function(ret,err){
  5.                 alert(JSON.stringify(ret));
  6.                 alert(JSON.stringify(err));
  7.             });

getMallGoodsList

查询店铺商品

getMallGoodsList({params},callback(ret, err))

params

param:

  • 类型 ： JSON
  • 描述 ： 查询条件

{

  1. mall_id:
  2. - 类型 ： LONG
  3. - 描述 ： （必填）店铺id
  4. - 默认值 ： 无
  6. page:
  7. - 类型 ： INTEGER
  8. - 描述 ： （可选项）返回的页数
  9. - 默认值 ： 1
  11. page_size:
  12. - 类型 ： INTEGER
  13. - 描述 ： （可选项）返回的每页推广位数量
  14. - 默认值 ： 100

}

callback(ret, err)

ret：

  • 类型：JSON 对象
  • 内部字段：
  1. {
  2.     total:0, // 总数
  3.     goods_list : []       // 数组中返回参数详见下方链接
  4. }

err：

  • 类型：JSON 对象
  • 内部字段：
  1. { 
  2.     errCode: 0       // 错误码，请参照最下方错误code详情地址
  3.     errMsg : ""      // 请配置正确的clientId 和 secret 及必填参数
  4. }

示例代码

  1.             var pinke = api.require('pinke');
  2.             pinke.getMallGoodsList({
  3.                 param : {
  4.                     mall_id : 123 ,
  5.                     page_number : 1,
  6.                     page_size:1
  7.                 }
  8.             },function(ret,err){
  9.                 alert(JSON.stringify(ret));
  10.                 alert(JSON.stringify(err));
  11.             });

getMallUrlGen

生成店铺推广链接

getMallUrlGen({params},callback(ret, err))

params

param:

  • 类型 ： JSON
  • 描述 ： 查询条件

{

  1. mall_id:
  2. - 类型 ： LONG
  3. - 描述 ： （必填）店铺id
  4. - 默认值 ： 无
  6. pid:
  7. - 类型 ： STRING
  8. - 描述 ： （必填）推广位
  9. - 默认值 ： 无
  11. generate_weapp_webview:
  12. - 类型 ： BOOLEAN
  13. - 描述 ： （可选项）是否生成唤起微信客户端链接，true-是，false-否
  14. - 默认值 ： false
  16. generate_short_url:
  17. - 类型 ： BOOLEAN
  18. - 描述 ： （可选项）是否生成短链接
  19. - 默认值 ： false
  21. multi_group:
  22. - 类型 ： BOOLEAN
  23. - 描述 ： （可选项）true--生成多人团推广链接 false--生成单人团推广链接
  24. - 默认值 ： false
  26. custom_parameters:
  27. - 类型 ： STRING
  28. - 描述 ： （可选项）自定义参数，为链接打上自定义标签
  29. - 默认值 ： 100

}

callback(ret, err)

ret：

  • 类型：JSON 对象
  • 内部字段：
  1. {
  2.     list : []       // 数组中返回参数详见下方链接
  3. }

https://open.pinduoduo.com/#/apidocument/port?id=pdd.ddk.mall.url.gen

err：

  • 类型：JSON 对象
  • 内部字段：
  1. { 
  2.     errCode: 0       // 错误码，请参照最下方错误code详情地址
  3.     errMsg : ""      // 请配置正确的clientId 和 secret 及必填参数
  4. }

示例代码

  1.             var pinke = api.require('pinke');
  2.             pinke.getMallUrlGen({
  3.                 param : {
  4.                     mall_id : 123,
  5.                     pid : '8346732_52548325'
  6.                 }
  7.             },function(ret,err){
  8.                 alert(JSON.stringify(ret));
  9.                 alert(JSON.stringify(err));
  10.             });

getLotteryUrlGen

生成转盘抽免单Url

getLotteryUrlGen({params},callback(ret, err))

此接口设置了权限，需要一定的订单数才可使用，具体请咨询官方客服

params

param:

  • 类型 ： JSON
  • 描述 ： 查询条件

{

  1. pid_list:
  2. - 类型 ： STRING[]
  3. - 描述 ： （必填）推广位
  4. - 默认值 ： 无
  6. generate_weapp_webview:
  7. - 类型 ： BOOLEAN
  8. - 描述 ： （可选项）是否生成唤起微信客户端链接，true-是，false-否
  9. - 默认值 ： false
  11. generate_short_url:
  12. - 类型 ： STRING
  13. - 描述 ： （可选项）是否生成短链接，true-是，false-否
  14. - 默认值 ： 无
  16. multi_group:
  17. - 类型 ： BOOLEAN
  18. - 描述 ： （可选项）true--生成多人团推广链接false--生成单人团推广链接
  19. - 默认值 ： false
  21. custom_parameters:
  22. - 类型 ： STRING
  23. - 描述 ： （可选项）自定义参数，为链接打上自定义标签
  24. - 默认值 ： 无

}

callback(ret, err)

ret：

  • 类型：JSON 对象
  • 内部字段：
  1. {
  2.     total:0, // 总数
  3.     url_list : []       // 数组中返回参数详见下方链接
  4. }

err：

  • 类型：JSON 对象
  • 内部字段：
  1. { 
  2.     errCode: 0       // 错误码，请参照最下方错误code详情地址
  3.     errMsg : ""      // 请配置正确的clientId 和 secret 及必填参数
  4. }

示例代码

  1.             var pinke = api.require('pinke');
  2.             pinke.getLotteryUrlGen({
  3.                 param : {
  4.                     pid_list : ['8346732_52548325']
  5.                 }
  6.             },function(ret,err){
  7.                 alert(JSON.stringify(ret));
  8.                 alert(JSON.stringify(err));
  9.             });

getLotteryNewList

查询转盘拉新订单

getLotteryNewList({params},callback(ret, err))

params

param:

  • 类型 ： JSON
  • 描述 ： 查询条件

{

  1. pid:
  2. - 类型 ： STRING
  3. - 描述 ： （可选项）推广位ID
  4. - 默认值 ： 1
  6. start_time:
  7. - 类型 ： LONG
  8. - 描述 ： （可选项）最后更新时间--查询时间开始。note：此时间为时间戳
  9. - 默认值 ： 无
  11. end_time:
  12. - 类型 ： LONG
  13. - 描述 ： （可选项）最后更新时间--查询时间结束。
  14. - 默认值 ： 无
  16. page_size:
  17. - 类型 ： INTEGER
  18. - 描述 ： （可选项）返回的每页结果列表数
  19. - 默认值 ： 100
  21. page:
  22. - 类型 ： INTEGER
  23. - 描述 ： （可选项）返回的页数
  24. - 默认值 ： 1
  26. customer_paramters:
  27. - 类型 ： STRING
  28. - 描述 ： （可选项）自定义参数，为链接打上自定义标签
  29. - 默认值 ： 无

}

callback(ret, err)

ret：

  • 类型：JSON 对象
  • 内部字段：
  1. {
  2.     page_num:1, // 页数
  3.     page_size:100, // 每月数量
  4.     total_count:100, // 总数
  5.     list : []       // 数组中返回参数详见下方链接
  6. }

https://open.pinduoduo.com/#/apidocument/port?id=pdd.ddk.lottery.new.list.get

err：

  • 类型：JSON 对象
  • 内部字段：
  1. { 
  2.     errCode: 0       // 错误码，请参照最下方错误code详情地址
  3.     errMsg : ""      // 请配置正确的clientId 和 secret 及必填参数
  4. }

示例代码

  1.             var pinke = api.require('pinke');
  2.             pinke.getLotteryNewList({
  3.                 param : {
  5.                 }
  6.             },function(ret,err){
  7.                 alert(JSON.stringify(ret));
  8.                 alert(JSON.stringify(err));
  9.             });

getResourceUrlGen

多多进宝频道推广

getResourceUrlGen({params},callback(ret, err))

params

param:

  • 类型 ： JSON
  • 描述 ： 查询条件

{

  1. pid:
  2. - 类型 ： STRING
  3. - 描述 ： （必填）推广位
  4. - 默认值 ： 无
  6. resource_type:
  7. - 类型 ： INTEGER
  8. - 描述 ： （可选项）频道来源：4-限时秒杀,39997-充值中心, 39998-转链type，39999-电器城
  9. - 默认值 ： 无
  11. url:
  12. - 类型 ： STRING
  13. - 描述 ： （可选项）原链接
  14. - 默认值 ： 无

}

callback(ret, err)

ret：

  • 类型：JSON 对象
  • 内部字段：
  1. {
  2.     multi_url_list: {}, // 单人团链接
  3.     single_url_list : []       // 多人团链接
  4. }

err：

  • 类型：JSON 对象
  • 内部字段：
  1. { 
  2.     errCode: 0       // 错误码，请参照最下方错误code详情地址
  3.     errMsg : ""      // 请配置正确的clientId 和 secret 及必填参数
  4. }

示例代码

  1.             var pinke = api.require('pinke');
  2.             pinke.getResourceUrlGen({
  3.                 param : {
  4.                     pid : '8346732_52548325'
  5.                 }
  6.             },function(ret,err){
  7.                 alert(JSON.stringify(ret));
  8.                 alert(JSON.stringify(err));
  9.             });

getMerchantList

查询店铺列表

getMerchantList({params},callback(ret, err))

params

param:

  • 类型 ： JSON
  • 描述 ： 查询条件

{

  1. mall_id_list:
  2. - 类型 ： LONG[]
  3. - 描述 ： （可选项）店铺id
  4. - 默认值 ： 无
  6. merchant_type_list:
  7. - 类型 ： INTEGER[]
  8. - 描述 ： （可选项）店铺类型
  9. - 默认值 ： 无
  11. query_range_str:
  12. - 类型 ： INTEGER
  13. - 描述 ： （可选项）查询范围0----商品拼团价格区间；1----商品券后价价格区间；2----佣金比例区间；3----优惠券金额区间；4----加入多多进宝时间区间；5----销量区间；6----佣金金额区间
  14. - 默认值 ： 无
  16. cat_id:
  17. - 类型 ： LONG
  18. - 描述 ： （可选项）商品类目ID
  19. - 默认值 ： 无
  21. has_coupon:
  22. - 类型 ： INTEGER
  23. - 描述 ： （可选项）是否有优惠券 （0 所有；1 必须有券。）
  24. - 默认值 ： 0
  26. page_number:
  27. - 类型 ： INTEGER
  28. - 描述 ： （可选项）返回的页数
  29. - 默认值 ： 1
  31. page_size:
  32. - 类型 ： INTEGER
  33. - 描述 ： （可选项）返回的每页数量
  34. - 默认值 ： 100
  36. range_vo_list:
  37. - 类型 ： STRING
  38. - 描述 ： （可选项）筛选范围
  39. - 默认值 ： 无

}

callback(ret, err)

ret：

  • 类型：JSON 对象
  • 内部字段：
  1. {
  2.     total:0, // 总数
  3.     mall_search_info_vo_list : []       // 数组中返回参数详见下方链接
  4. }

https://open.pinduoduo.com/#/apidocument/port?id=pdd.ddk.merchant.list.get

err：

  • 类型：JSON 对象
  • 内部字段：
  1. { 
  2.     errCode: 0       // 错误码，请参照最下方错误code详情地址
  3.     errMsg : ""      // 请配置正确的clientId 和 secret 及必填参数
  4. }

示例代码

  1.             pinke.getMerchantList({
  2.                 param : {
  3.                     range_vo_list : 'AJ'
  4.                 }
  5.             },function(ret,err){
  6.                 alert(JSON.stringify(ret));
  7.                 alert(JSON.stringify(err));
  8.             });

getTopGoodsList

获取爆款排行商品

getTopGoodsList({params},callback(ret, err))

params

param:

  • 类型 ： JSON
  • 描述 ： 查询条件

{

  1. p_id:
  2. - 类型 ： STRING
  3. - 描述 ： （可选项）推广位id
  4. - 默认值 ： 无
  6. offset:
  7. - 类型 ： INTEGER
  8. - 描述 ： （可选项）从多少位置开始请求；
  9. - 默认值 ： 0
  11. sort_type:
  12. - 类型 ： INTEGER
  13. - 描述 ： （可选项）1-实时热销榜；2-实时收益榜
  14. - 默认值 ： 1
  16. limit:
  17. - 类型 ： INTEGER
  18. - 描述 ： （可选项）请求数量
  19. - 默认值 ： 400

}

callback(ret, err)

ret：

  • 类型：JSON 对象
  • 内部字段：
  1. {
  2.     total:0, // 总数
  3.     list : []       // 数组中返回参数详见下方链接
  4. }

err：

  • 类型：JSON 对象
  • 内部字段：
  1. { 
  2.     errCode: 0       // 错误码，请参照最下方错误code详情地址

其他

因为多多客开放平台开放时间不长，很多地方官方还未完善，如出现问题或未及时更新，请在群众交流，QQ群号码在最下方。

\==申请流程==

1.注册登录多多进宝网站：jinbao.pinduoduo.com

2.选择API权限-申请-等待审核

3.审核通过在API权限下会显示账户的ClientID，点击按钮- 前往查看API文档（跳转的是拼多多开放平台）

4.同样注册申请，需要上传开发者的身份证信息，如果是企业开发者需要上传营业执照等信息，等待审核。

5.审核通过在上方菜单栏-控制台-我的应用-创建应用-选择多多客联盟

6.填写应用基本信息-包括mrd文档与prd文档（有模版，按照模版写就可以，现在不用写的特别全面，基本都会审核通过）

7.回调地址指的是当有回调事件方式时，回传的地址（如果你没有服务端，就需要去申请一个免费的建站，我之前是在凡客注册的一个，是免费的）

8.官方地址（同上）

9.提交审核

10.审核成功后在控制台-我的应用下会看到创建的应用，查看详情，里面有应用的相关信息包括相关的key信息。

11.如果有其他问题可以加入QQ 群讨论，请务必标名是通过apicloud，群号码：738256791

可用性

Android系统