拼多多開放平臺 SDK · golang

[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 可以通過創建多多客聯盟應用獲取權限