拼多多开放平台 SDK
最后更新于：2022-04-02 04:57:54
[https://github.com/liunian1004/pdd](https://github.com/liunian1004/pdd)
本项目为`go`语言实现的拼多多开放平台 SDK，调用方式简单粗暴。
`go get github.com/liunian1004/pdd`
~~~go
import github.com/liunian1004/pdd
p := pdd.NewPdd(&pdd.Config{
ClientId: "your client id",
ClientSecret: "your client secret",
RetryTimes: 3, // 设置接口调用失败重试次数
})
// 初始化多多客相关 API 调用
d := p.GetDDK()
// 或者
d := ddk.NewDDK(&pdd.Config{
ClientId: "your client id",
ClientSecret: "your client secret",
RetryTimes: 3, // 设置接口调用失败重试次数
})
// 获取主题列表
r, err := d.ThemeListGet(1, 20)
// 初始化商品 API
g := p.GetGoodsAPI()
~~~
## [](https://github.com/liunian1004/pdd#%E9%9D%9E%E5%BF%85%E9%A1%BB%E5%8F%82%E6%95%B0)非必须参数
通过自定义 Params 定制非必须参数，在函数的最后一个参数传入 Params 对象。
~~~go
d := NewDDK(p)
params := pdd.NewParams()
// 设置非必传参数
params.Set("custom_parameters", "test")
params.Set("generate_short_url", true)
s, err := d.RPPromUrlGenerate([]string{"pid"}, true, params)
~~~
## [](https://github.com/liunian1004/pdd#todo)Todo
* \[\] 实现 ddk 多多客 API 相关接口
* [x] `OrderListIncrementGet()`pdd.ddk.order.list.increment.get 最后更新时间段增量同步推广订单信息
* [x] `GoodsDetail()`pdd.ddk.goods.detail 多多进宝商品详情查询
* [x] `GoodsSearch()`pdd.ddk.goods.search 多多进宝商品查询
* [x] `GoodsPidQuery()`pdd.ddk.goods.pid.query 查询已经生成的推广位信息
* [x] `GoodsPidGenerate()`pdd.ddk.goods.pid.generate 创建多多进宝推广位
* [x] `GoodsPromotionUrlGenerate()`pdd.ddk.goods.promotion.url.generate 多多进宝推广链接生成
* [x] `TopGoodsListQuery()`pdd.ddk.top.goods.list.query 获取热销商品列表
* [x] `RPPromUrlGenerate()`pdd.ddk.rp.prom.url.generate 生成红包推广链接 （**需要对应权限**）
* [x] `CMSPromUrlGen()`pdd.ddk.cms.prom.url.generate 生成商城-频道推广链接
* [x] `ThemeListGet()`pdd.ddk.theme.list.get 多多进宝主题列表查询
* \[\] pdd.ddk.theme.goods.search 多多进宝主题商品查询
* \[\] pdd.ddk.theme.prom.url.generate 多多进宝主题推广链接生成
* \[\] pdd.ddk.app.new.bill.list.get 多多客拉新账单
* \[\] pdd.ddk.direct.goods.query 定向推广商品查询接口
* [x] `GoodsZsURLGen()`pdd.ddk.goods.zs.unit.url.gen 多多进宝转链接口
* \[\] pdd.ddk.zs.unit.goods.query 查询招商推广计划商品
* \[\] pdd.ddk.weapp.qrcode.url.gen 多多客生成单品推广小程序二维码 url
* \[\] pdd.ddk.goods.basic.info.get 获取商品基本信息接口
* \[\] pdd.ddk.goods.recommend.get 运营频道商品查询 API
* \[\] pdd.ddk.order.detail.get 查询订单详情
* \[\] pdd.ddk.mall.goods.list.get 查询店铺商品
* \[\] pdd.ddk.mall.url.gen 多多客生成店铺推广链接 API
* [x] `LotteryUrlGen()`pdd.ddk.lottery.url.gen 多多客生成转盘抽免单 url （**需要对应权限**）
* \[\] pdd.ddk.lottery.new.list.get 多多客查询转盘拉新订单列表
* \[\] pdd.ddk.resource.url.gen 生成多多进宝频道推广
* \[\] pdd.ddk.merchant.list.get 多多客查店铺列表接口
* 商品 API
* [x] `GoodsCatGet()`pdd.goods.cats.get 拼多多标准商品类目信息
* [x] `GoodsOptGet()`pdd.goods.opt.get 拼多多商品标签列表
## [](https://github.com/liunian1004/pdd#%E5%A4%9A%E5%A4%9A%E5%AE%A2%E5%B7%A5%E5%85%B7-api)多多客工具 API
提供给第三方开发者为多多进宝推广者提供第三方工具的 API。
* pdd.ddk.oauth.goods.pid.generate（多多进宝推广位创建接口）
* pdd.ddk.oauth.goods.pid.query（多多客已生成推广位信息查询）
* pdd.ddk.oauth.goods.prom.url.generate（生成多多进宝推广链接）
* pdd.ddk.oauth.order.list.increment.get（按照更新时间段增量同步推广订单信息）
* pdd.ddk.oauth.order.list.range.get（按照时间段获取多多进宝推广订单信息）
## [](https://github.com/liunian1004/pdd#%E6%B3%A8%E6%84%8F%E4%BA%8B%E9%A1%B9)注意事项
1. 多多客工具API需要多多客授权才能使用，授权服务URL为[http://jinbao.pinduoduo.com/open.html](http://jinbao.pinduoduo.com/open.html)，根据接入指南提示组装合法的 URL，示例：[http://jinbao.pinduoduo.com/open.html?client\_id=89daeb71b2e546318fbb53cd04d0329c&redirect\_uri=www.pinduoduo.com&response\_type=code，之后引导多多客授权获取code即可。](http://jinbao.pinduoduo.com/open.html?client_id=89daeb71b2e546318fbb53cd04d0329c&redirect_uri=www.pinduoduo.com&response_type=code%EF%BC%8C%E4%B9%8B%E5%90%8E%E5%BC%95%E5%AF%BC%E5%A4%9A%E5%A4%9A%E5%AE%A2%E6%8E%88%E6%9D%83%E8%8E%B7%E5%8F%96code%E5%8D%B3%E5%8F%AF%E3%80%82)
2. code、access\_token、refresh\_token 失效时间与商家授权一致，分别为10分钟、24小时、30天，刷新token后分别延长access\_token和refresh\_token的失效时间，延长时间等同于授权时长，获取token教程详见：[http://open.pinduoduo.com/#/document](http://open.pinduoduo.com/#/document)
3. 调用多多客工具 API 时，必须入参 access\_token 方可正常调用
4. 多多客工具 API 可以通过创建多多客联盟应用获取权限
';