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相关信息(申请流程见底部)。

  1. <feature name="pinke">
  2. <param name="clientId" value="7dfa49729XXXXXXXXX"/>
  3. <param name="clientSecret" value="8d55ee3XXXXXXXXXX"/>
  4. </feature>

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

模块接口

init

初始化模块

init()

params

callback(ret, err)

示例代码

  1. var pinke = api.require('pinke');
  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. timeunix时间戳。
  5. - 默认值
  6. end_update_time:
  7. - 类型 LONG
  8. - 描述 (必填)查询结束时间,和开始时间相差不能超过24小时。
  9. - 默认值
  10. page_size:
  11. - 类型 INTEGER
  12. - 描述 返回的每页结果订单数
  13. - 默认值:100
  14. page:
  15. - 类型 INTEGER
  16. - 描述 页数
  17. - 默认值:1
  18. return_count:
  19. - 类型 BOOLEAN
  20. - 描述 是否返回总数
  21. - 默认值: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. - 默认值
  5. pid:
  6. - 类型 STRING
  7. - 描述 (可选项)推广位id
  8. - 默认值
  9. custom_parameters:
  10. - 类型 STRING
  11. - 描述 (可选项)自定义参数
  12. - 默认值
  13. zs_duo_id:
  14. - 类型 LONG
  15. - 描述 (可选项)招商多多客ID
  16. - 默认值
  17. plan_type:
  18. - 类型 INTEGER
  19. - 描述 (可选项)佣金优惠券对应推广类型,3:专属 4:招商
  20. - 默认值

}

callback(ret, err)

ret:

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

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

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. - 默认值
  5. opt_id:
  6. - 类型 LONG
  7. - 描述 (可选项)商品标签类目ID
  8. - 默认值
  9. page:
  10. - 类型 INTEGER
  11. - 描述 (可选项)商品分页数
  12. - 默认值 1
  13. page_size:
  14. - 类型 INTEGER
  15. - 描述 (可选项)每页商品数量
  16. - 默认值 100
  17. sort_type:
  18. - 类型 INTEGER
  19. - 描述 (可选项)排序方式:0-31 可至下方此接口链接处查询
  20. - 默认值 0
  21. with_coupon:
  22. - 类型 BOOLEAN
  23. - 描述 (可选项)是否只返回优惠券的商品
  24. - 默认值 false
  25. range_list:
  26. - 类型 INTEGER
  27. - 描述 (可选项)筛选范围:[{"range_id":0,"range_from":1,"range_to":1500},{"range_id":1,"range_from":1,"range_to":1500}]
  28. - 默认值
  29. cat_id:
  30. - 类型 LONG
  31. - 描述 (可选项)商品类目ID
  32. - 默认值
  33. goods_id_list:
  34. - 类型 LONG[]
  35. - 描述 (可选项)商品ID列表。例如:[123456,123]
  36. - 默认值
  37. merchant_type:
  38. - 类型 LONG[]
  39. - 描述 (可选项)商品ID列表。例如:[123456,123]
  40. - 默认值
  41. pid:
  42. - 类型 STRING
  43. - 描述 (可选项)推广位id
  44. - 默认值
  45. custom_parameters:
  46. - 类型 STRING
  47. - 描述 (可选项)自定义参数
  48. - 默认值

}

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
  5. page_size:
  6. - 类型 INTEGER
  7. - 描述 (可选项)返回的每页推广位数量
  8. - 默认值 100

}

callback(ret, err)

ret:

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

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

err:

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

示例代码

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

getPidGenerate

创建多多进宝推广位

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

params

param:

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

{

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

}

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. - 默认值
  5. goods_id_list:
  6. - 类型 LONG[]
  7. - 描述 (必填)商品ID,仅支持单个查询
  8. - 默认值
  9. generate_short_url:
  10. - 类型 BOOLEAN
  11. - 描述 (可选项)是否生成短链接
  12. - 默认值 false
  13. multi_group:
  14. - 类型 BOOLEAN
  15. - 描述 (可选项)true--生成多人团推广链接 false--生成单人团推广链接
  16. - 默认值 false
  17. custom_parameters:
  18. - 类型 STRING
  19. - 描述 (可选项)自定义参数
  20. - 默认值 100
  21. generate_weapp_webview:
  22. - 类型 BOOLEAN
  23. - 描述 (可选项)是否生成唤起微信客户端链接
  24. - 默认值 false
  25. zs_duo_id:
  26. - 类型 LONG
  27. - 描述 (可选项)招商多多客ID
  28. - 默认值
  29. generate_we_app:
  30. - 类型 BOOLEAN
  31. - 描述 (可选项)是否生成小程序推广
  32. - 默认值 false

}

callback(ret, err)

ret:

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

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

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. timeunix时间戳。
  5. - 默认值
  6. end_update_time:
  7. - 类型 LONG
  8. - 描述 (必填)查询结束时间,和开始时间相差不能超过24小时。
  9. - 默认值
  10. page_size:
  11. - 类型 INTEGER
  12. - 描述 返回的每页结果订单数
  13. - 默认值:100
  14. page:
  15. - 类型 INTEGER
  16. - 描述 页数
  17. - 默认值:1
  18. return_count:
  19. - 类型 BOOLEAN
  20. - 描述 是否返回总数
  21. - 默认值: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))

params

param:

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

{

  1. parent_opt_id:
  2. - 类型 INTEGER
  3. - 描述 (必填)值=0时为顶点opt_id,通过树顶级节点获取opt
  4. - 默认值

}

callback(ret, err)

ret:

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

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

err:

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

示例代码

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

getRpPromUrlGenerate

生成红包推广链接接口

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

params

param:

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

{

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

}

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

}

callback(ret, err)

ret:

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

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

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
  5. page_size:
  6. - 类型 INTEGER
  7. - 描述 (可选项)返回的每页推广位数量
  8. - 默认值 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 : {
  4. }
  5. },function(ret,err){
  6. alert(JSON.stringify(ret));
  7. alert(JSON.stringify(err));
  8. });

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. }

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

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. - 默认值
  5. theme_id_list:
  6. - 类型 LONG[]
  7. - 描述 (必填)主题ID列表,例如[1,235]
  8. - 默认值
  9. generate_short_url:
  10. - 类型 BOOLEAN
  11. - 描述 (可选项)是否生成短链接,true-是,false-否
  12. - 默认值 false
  13. generate_mobile:
  14. - 类型 BOOLEAN
  15. - 描述 (可选项)是否生成手机跳转链接。true-是,false-否
  16. - 默认值 false
  17. custom_parameters:
  18. - 类型 STRING
  19. - 描述 (可选项)自定义参数,为链接打上自定义标签
  20. - 默认值
  21. generate_weapp_webview:
  22. - 类型 BOOLEAN
  23. - 描述 (可选项)是否唤起微信客户端,false 否,true
  24. - 默认值 false
  25. we_app_web_view_short_url:
  26. - 类型 BOOLEAN
  27. - 描述 (可选项)唤起微信app推广短链接
  28. - 默认值 false
  29. we_app_web_wiew_url:
  30. - 类型 BOOLEAN
  31. - 描述 (可选项)唤起微信app推广链接
  32. - 默认值 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
  5. page_size:
  6. - 类型 INTEGER
  7. - 描述 (可选项)返回的每页推广位数量
  8. - 默认值 100

}

callback(ret, err)

ret:

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

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

err:

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

示例代码

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

getGoodsZsUnitUrlGen

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

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

params

param:

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

{

  1. source_url:
  2. - 类型 STRING
  3. - 描述 (必填)需转链的链接
  4. - 默认值
  5. pid:
  6. - 类型 STRING
  7. - 描述 (必填)渠道id
  8. - 默认值 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. - 默认值
  5. goods_id_list:
  6. - 类型 LONG[]
  7. - 描述 (必填)商品ID,仅支持单个查询
  8. - 默认值
  9. custom_parameters:
  10. - 类型 STRING
  11. - 描述 (可选项)自定义参数,为链接打上自定义标签
  12. - 默认值
  13. zs_duo_id:
  14. - 类型 LONG
  15. - 描述 (可选项)招商多多客ID
  16. - 默认值

}

callback(ret, err)

ret:

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

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

err:

  • 类型:JSON 对象
  • 内部字段:
  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. - 默认值

}

callback(ret, err)

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. }

示例代码

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

getGoodsRecommend

运营频道商品查询

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

params

param:

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

{

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

}

callback(ret, err)

ret:

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

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

err:

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

示例代码

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

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. - 默认值
  5. page:
  6. - 类型 INTEGER
  7. - 描述 (可选项)返回的页数
  8. - 默认值 1
  9. page_size:
  10. - 类型 INTEGER
  11. - 描述 (可选项)返回的每页推广位数量
  12. - 默认值 100

}

callback(ret, err)

ret:

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

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

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. - 默认值
  5. pid:
  6. - 类型 STRING
  7. - 描述 (必填)推广位
  8. - 默认值
  9. generate_weapp_webview:
  10. - 类型 BOOLEAN
  11. - 描述 (可选项)是否生成唤起微信客户端链接,true-是,false-否
  12. - 默认值 false
  13. generate_short_url:
  14. - 类型 BOOLEAN
  15. - 描述 (可选项)是否生成短链接
  16. - 默认值 false
  17. multi_group:
  18. - 类型 BOOLEAN
  19. - 描述 (可选项)true--生成多人团推广链接 false--生成单人团推广链接
  20. - 默认值 false
  21. custom_parameters:
  22. - 类型 STRING
  23. - 描述 (可选项)自定义参数,为链接打上自定义标签
  24. - 默认值 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. - 默认值
  5. generate_weapp_webview:
  6. - 类型 BOOLEAN
  7. - 描述 (可选项)是否生成唤起微信客户端链接,true-是,false-否
  8. - 默认值 false
  9. generate_short_url:
  10. - 类型 STRING
  11. - 描述 (可选项)是否生成短链接,true-是,false-否
  12. - 默认值
  13. multi_group:
  14. - 类型 BOOLEAN
  15. - 描述 (可选项)true--生成多人团推广链接false--生成单人团推广链接
  16. - 默认值 false
  17. custom_parameters:
  18. - 类型 STRING
  19. - 描述 (可选项)自定义参数,为链接打上自定义标签
  20. - 默认值

}

callback(ret, err)

ret:

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

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

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
  5. start_time:
  6. - 类型 LONG
  7. - 描述 (可选项)最后更新时间--查询时间开始。note:此时间为时间戳
  8. - 默认值
  9. end_time:
  10. - 类型 LONG
  11. - 描述 (可选项)最后更新时间--查询时间结束。
  12. - 默认值
  13. page_size:
  14. - 类型 INTEGER
  15. - 描述 (可选项)返回的每页结果列表数
  16. - 默认值 100
  17. page:
  18. - 类型 INTEGER
  19. - 描述 (可选项)返回的页数
  20. - 默认值 1
  21. customer_paramters:
  22. - 类型 STRING
  23. - 描述 (可选项)自定义参数,为链接打上自定义标签
  24. - 默认值

}

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 : {
  4. }
  5. },function(ret,err){
  6. alert(JSON.stringify(ret));
  7. alert(JSON.stringify(err));
  8. });

getResourceUrlGen

多多进宝频道推广

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

params

param:

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

{

  1. pid:
  2. - 类型 STRING
  3. - 描述 (必填)推广位
  4. - 默认值
  5. resource_type:
  6. - 类型 INTEGER
  7. - 描述 (可选项)频道来源:4-限时秒杀,39997-充值中心, 39998-转链type39999-电器城
  8. - 默认值
  9. url:
  10. - 类型 STRING
  11. - 描述 (可选项)原链接
  12. - 默认值

}

callback(ret, err)

ret:

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

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

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. - 默认值
  5. merchant_type_list:
  6. - 类型 INTEGER[]
  7. - 描述 (可选项)店铺类型
  8. - 默认值
  9. query_range_str:
  10. - 类型 INTEGER
  11. - 描述 (可选项)查询范围0----商品拼团价格区间;1----商品券后价价格区间;2----佣金比例区间;3----优惠券金额区间;4----加入多多进宝时间区间;5----销量区间;6----佣金金额区间
  12. - 默认值
  13. cat_id:
  14. - 类型 LONG
  15. - 描述 (可选项)商品类目ID
  16. - 默认值
  17. has_coupon:
  18. - 类型 INTEGER
  19. - 描述 (可选项)是否有优惠券 0 所有;1 必须有券。)
  20. - 默认值 0
  21. page_number:
  22. - 类型 INTEGER
  23. - 描述 (可选项)返回的页数
  24. - 默认值 1
  25. page_size:
  26. - 类型 INTEGER
  27. - 描述 (可选项)返回的每页数量
  28. - 默认值 100
  29. range_vo_list:
  30. - 类型 STRING
  31. - 描述 (可选项)筛选范围
  32. - 默认值

}

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. - 默认值
  5. offset:
  6. - 类型 INTEGER
  7. - 描述 (可选项)从多少位置开始请求;
  8. - 默认值 0
  9. sort_type:
  10. - 类型 INTEGER
  11. - 描述 (可选项)1-实时热销榜;2-实时收益榜
  12. - 默认值 1
  13. limit:
  14. - 类型 INTEGER
  15. - 描述 (可选项)请求数量
  16. - 默认值 400

}

callback(ret, err)

ret:

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

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

err:

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

示例代码

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

其他

因为多多客开放平台开放时间不长,很多地方官方还未完善,如出现问题或未及时更新,请在群众交流,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及更高版本