Skip to content

Commit

Permalink
跟随官方文档更新接口
Browse files Browse the repository at this point in the history 
对参数进行多维数组的处理
  • Loading branch information
@ennnnny
ennnnny committed Dec 8, 2019
1 parent 7c1aa55 commit f3ff7c3
Show file tree
Hide file tree
Showing 14 changed files with 204 additions and 119 deletions.
82 changes: 43 additions & 39 deletions README.md
View file
Original file line number Diff line number Diff line change
Expand Up @@ -41,53 +41,57 @@ print_r($res);

| 接口名称 | 对应方法 |
| -------- | ---- |
| taobao.tbk.item.get (淘宝客商品查询) | \$app->item->get() |
| taobao.tbk.item.convert (淘宝客商品链接转换)[**官网貌似已移除此接口**] | \$app->item->convert() |
| taobao.tbk.item.recommend.get (淘宝客商品关联推荐查询) | \$app->item->getRecommend() |
| taobao.tbk.item.info.get (淘宝客商品详情（简版）) | \$app->item->getInfo() |
| taobao.tbk.shop.get (淘宝客店铺查询) | \$app->shop->get() |
| taobao.tbk.shop.recommend.get (淘宝客店铺关联推荐查询) | \$app->shop->getRecommend() |
| taobao.tbk.rebate.auth.get (淘宝客返利授权查询)[**官网貌似已移除此接口**] | \$app->rebate->getAuth() |
| taobao.tbk.rebate.order.get (淘宝客返利订单查询)[**官网貌似已移除此接口**] | \$app->rebate->getOrder() |
| taobao.tbk.item.get (淘宝客商品查询)[**官网貌似已移除此接口**] | \$app->item->get() |
| taobao.tbk.item.convert (淘宝客-推广者-商品链接转换) | \$app->item->convert() |
| taobao.tbk.item.recommend.get (淘宝客-公用-商品关联推荐) | \$app->item->getRecommend() |
| taobao.tbk.item.info.get (淘宝客-公用-淘宝客商品详情查询(简版)) | \$app->item->getInfo() |
| taobao.tbk.shop.get (淘宝客-推广者-店铺搜索) | \$app->shop->get() |
| taobao.tbk.shop.recommend.get (淘宝客-公用-店铺关联推荐) | \$app->shop->getRecommend() |
| taobao.tbk.rebate.auth.get (淘宝客-推广者-返利商家授权查询) | \$app->rebate->getAuth() |
| taobao.tbk.rebate.order.get (淘宝客-推广者-返利订单查询) | \$app->rebate->getOrder() |
| taobao.tbk.uatm.event.get (枚举正在进行中的定向招商的活动列表)[**官网貌似已移除此接口**] | \$app->uatm->getEvent() |
| taobao.tbk.uatm.event.item.get (获取淘宝联盟定向招商的宝贝信息)[**官网貌似已移除此接口**] | \$app->uatm->getItemEvent() |
| taobao.tbk.uatm.favorites.item.get (获取淘宝联盟选品库的宝贝信息) | \$app->uatm->getItemFavorites() |
| taobao.tbk.uatm.favorites.get (获取淘宝联盟选品库列表) | \$app->uatm->getFavorites() |
| taobao.tbk.uatm.favorites.item.get (淘宝客-推广者-选品库宝贝信息) | \$app->uatm->getItemFavorites() |
| taobao.tbk.uatm.favorites.get (淘宝客-推广者-选品库宝贝列表) | \$app->uatm->getFavorites() |
| taobao.tbk.ju.tqg.get (淘抢购api) | \$app->ju->getTqg() |
| taobao.tbk.item.click.extract (链接解析api) | \$app->item->clickExtract() |
| taobao.tbk.spread.get (物料传播方式获取)[**官网貌似已移除此接口**] | \$app->spread->get() |
| taobao.tbk.item.click.extract (淘宝客-公用-链接解析出商品id) | \$app->item->clickExtract() |
| taobao.tbk.spread.get (淘宝客-公用-长链转短链) | \$app->spread->get() |
| taobao.tbk.item.guess.like (淘宝客商品猜你喜欢) | \$app->item->likeGuess() |
| taobao.tbk.dg.item.coupon.get (好券清单API【导购】) | \$app->dg->getCoupon() |
| taobao.tbk.coupon.get (阿里妈妈推广券信息查询) | \$app->coupon->get() |
| taobao.tbk.tpwd.create (淘宝客淘口令) | \$app->tpwd->create() |
| taobao.tbk.content.get (淘客媒体内容输出)[**官网貌似已移除此接口**] | \$app->content->get() |
| taobao.tbk.dg.newuser.order.get (淘宝客新用户订单API--导购) | \$app->dg->getOrderNewUser() |
| taobao.tbk.sc.newuser.order.get (淘宝客新用户订单API--社交) | \$app->sc->getOrderNewUser() |
| taobao.tbk.sc.material.optional (通用物料搜索API)[**官网貌似已移除此接口**] | \$app->sc->materialOptional() |
| taobao.tbk.dg.optimus.material (淘宝客物料下行-导购) | \$app->dg->materialOptimus() |
| taobao.tbk.dg.material.optional (通用物料搜索API（导购）) | \$app->dg->materialOptional() |
| taobao.tbk.dg.newuser.order.sum (拉新活动汇总API--导购) | \$app->dg->sumOrderNewUser() |
| taobao.tbk.sc.newuser.order.sum (拉新活动汇总API--社交) | \$app->sc->sumOrderNewUser() |
| taobao.tbk.sc.optimus.material (淘宝客擎天柱通用物料API - 社交) | \$app->sc->materialOptimus() |
| taobao.tbk.sc.publisher.info.save (淘宝客渠道信息备案 - 社交)[**官网貌似已移除此接口**] | \$app->sc->savePublisherInfo() |
| taobao.tbk.sc.publisher.info.get (淘宝客信息查询 - 社交)[**官网貌似已移除此接口**] | \$app->sc->getPublisherInfo() |
| taobao.tbk.sc.invitecode.get (淘宝客邀请码生成-社交)[**官网貌似已移除此接口**] | \$app->sc->getInviteCode() |
| taobao.tbk.sc.groupchat.message.send( 手淘群发单 )[**官网貌似已移除此接口**] | \$app->sc->sendGroupchat() |
| taobao.tbk.sc.groupchat.create( 手淘群创建 )[**官网貌似已移除此接口**] | \$app->sc->createGroupchat() |
| taobao.tbk.sc.groupchat.get( 手淘群查询 )[**官网貌似已移除此接口**] | \$app->sc->getGroupchat() |
| taobao.tbk.dg.item.coupon.get (好券清单API【导购】)[**官网貌似已移除此接口**] | \$app->dg->getCoupon() |
| taobao.tbk.coupon.get (淘宝客-公用-阿里妈妈推广券详情查询) | \$app->coupon->get() |
| taobao.tbk.tpwd.create (淘宝客-公用-淘口令生成) | \$app->tpwd->create() |
| taobao.tbk.content.get (淘宝客-推广者-图文内容输出) | \$app->content->get() |
| taobao.tbk.dg.newuser.order.get (淘宝客-推广者-新用户订单明细查询) | \$app->dg->getOrderNewUser() |
| taobao.tbk.sc.newuser.order.get (淘宝客-服务商-新用户订单明细查询) | \$app->sc->getOrderNewUser() |
| taobao.tbk.sc.material.optional (淘宝客-服务商-物料搜索) | \$app->sc->materialOptional() |
| taobao.tbk.dg.optimus.material (淘宝客-推广者-物料精选) | \$app->dg->materialOptimus() |
| taobao.tbk.dg.material.optional (淘宝客-推广者-物料搜索) | \$app->dg->materialOptional() |
| taobao.tbk.dg.newuser.order.sum (淘宝客-推广者-拉新活动对应数据查询) | \$app->dg->sumOrderNewUser() |
| taobao.tbk.sc.newuser.order.sum (淘宝客-服务商-拉新活动对应数据查询) | \$app->sc->sumOrderNewUser() |
| taobao.tbk.sc.optimus.material (淘宝客-服务商-物料精选) | \$app->sc->materialOptimus() |
| taobao.tbk.sc.publisher.info.save (淘宝客-公用-私域用户备案) | \$app->sc->savePublisherInfo() |
| taobao.tbk.sc.publisher.info.get (淘宝客-公用-私域用户备案信息查询) | \$app->sc->getPublisherInfo() |
| taobao.tbk.sc.invitecode.get (淘宝客-公用-私域用户邀请码生成) | \$app->sc->getInviteCode() |
| taobao.tbk.sc.groupchat.message.send(淘宝客-服务商-手淘群发单) | \$app->sc->sendGroupchat() |
| taobao.tbk.sc.groupchat.create(淘宝客-服务商-手淘群创建) | \$app->sc->createGroupchat() |
| taobao.tbk.sc.groupchat.get(淘宝客-服务商-手淘群查询) | \$app->sc->getGroupchat() |
| taobao.tbk.offline.sc.info.save( 线下新零售渠道备案 )[**官网貌似已移除此接口**] | \$app->sc->saveOfflineInfo() |
| taobao.tbk.dg.vegas.tlj.create( 淘礼金创建 )[**官网貌似已移除此接口**] | \$app->dg->createTlj() |
| taobao.tbk.activitylink.get( 淘宝联盟官方活动推广API-媒体 ) | \$app->content->getActivityLink() |
| taobao.tbk.sc.activitylink.toolget( 淘宝联盟官方活动推广API-工具 ) | \$app->sc->getActivityTool() |
| taobao.tbk.dg.punish.order.get( 处罚订单查询 -导购-私域用户管理专用 ) | \$app->dg->getPunishOrder() |
| taobao.tbk.order.get( 淘宝客订单查询 ) | \$app->order->get() |
| taobao.tbk.relation.refund( 淘宝客-推广者-维权退款订单查询 ) | \$app->order->getRefund() |
| taobao.tbk.order.details.get( 淘宝客-推广者-所有订单查询 ) | \$app->order->getDetails() |
| taobao.tbk.content.effect.get( 淘宝客-推广者-图文内容效果数据 ) | \$app->content->getEffect() |
| taobao.tbk.dg.vegas.tlj.create( 淘宝客-推广者-淘礼金创建 ) | \$app->dg->createTlj() |
| taobao.tbk.activitylink.get( 淘宝客-推广者-官方活动转链 ) | \$app->content->getActivityLink() |
| taobao.tbk.sc.activitylink.toolget( 淘宝客-服务商-官方活动转链 ) | \$app->sc->getActivityTool() |
| taobao.tbk.dg.punish.order.get( 淘宝客-推广者-处罚订单查询 ) | \$app->dg->getPunishOrder() |
| taobao.tbk.order.get( 淘宝客订单查询 )[**官网貌似已移除此接口**] | \$app->order->get() |
| taobao.tbk.relation.refund(淘宝客-推广者-维权退款订单查询) | \$app->order->getRefund() |
| taobao.tbk.order.details.get(淘宝客-推广者-所有订单查询) | \$app->order->getDetails() |
| taobao.tbk.dg.vegas.tlj.instance.report(淘宝客-推广者-淘礼金发放及使用报表) | \$app->dg->getTljReport() |
| taobao.tbk.dg.wish.update(媒体导购单选品) | \$app->dg->updateWish() |
| taobao.tbk.dg.wish.list(媒体淘客导购单查询) | \$app->dg->getWishList() |

## 支持

- 官方API文档： http://open.taobao.com/docs/api.htm?apiId=24515
- 淘宝客订单API： https://open.taobao.com/api.htm?docId=24527&docType=2&scopeId=11650
- 官方API文档： https://open.taobao.com/api.htm?docId=24517&docType=2
- 淘宝客订单API： https://open.taobao.com/api.htm?docId=43328&docType=2
- composer： https://getcomposer.org/

## License
Expand Down
27 changes: 22 additions & 5 deletions src/Tbk/Content/Client.php
View file
Original file line number Diff line number Diff line change
Expand Up @@ -20,10 +20,9 @@
*/
class Client extends BaseClient
{

/**
* taobao.tbk.content.get (淘客媒体内容输出)
* @line http://open.taobao.com/docs/api.htm?apiId=31137&docType=2
* taobao.tbk.content.get (淘宝客-推广者-图文内容输出)
* @line https://open.taobao.com/api.htm?docId=31137&docType=2
* @param array $params
* @return array|mixed|\SimpleXMLElement|string
*/
Expand All @@ -34,15 +33,33 @@ public function get(array $params)
}

/**
* 淘宝联盟官方活动推广API-媒体
* taobao.tbk.activitylink.get (淘宝客-推广者-官方活动转链)
* @line https://open.taobao.com/api.htm?docId=41918&docType=2
* @param array $params
* @return array|mixed|\SimpleXMLElement|string
*/
public function getActivityLink(array $params)
public function getActivityLink(array $params)
{
$res = $this->httpPost('taobao.tbk.activitylink.get', $params);
return $res;
}

/**
* taobao.tbk.content.effect.get (淘宝客-推广者-图文内容效果数据)
* @link https://open.taobao.com/api.htm?docId=37130&docType=2
* @param array $params
* @return array|mixed|\SimpleXMLElement|string
*/
public function getEffect(array $params)
{
if (isset($params['option']) && is_array($params['option'])) {
$data['option'] = json_encode($params['option']);
} elseif (is_array($params)) {
$data['option'] = json_encode($params);
} else {
$data['option'] = $params;
}
$res = $this->httpPost('taobao.tbk.content.effect.get', $data);
return $res;
}
}
6 changes: 2 additions & 4 deletions src/Tbk/Coupon/Client.php
View file
Original file line number Diff line number Diff line change
Expand Up @@ -20,10 +20,9 @@
*/
class Client extends BaseClient
{

/**
* taobao.tbk.coupon.get (阿里妈妈推广券信息查询)
* @line http://open.taobao.com/docs/api.htm?apiId=31106&docType=2
* taobao.tbk.coupon.get (淘宝客-公用-阿里妈妈推广券详情查询)
* @line https://open.taobao.com/api.htm?docId=31106&docType=2
* @param array $params
* @return array|mixed|\SimpleXMLElement|string
*/
Expand All @@ -32,5 +31,4 @@ public function get(array $params)
$res = $this->httpPost('taobao.tbk.coupon.get', $params);
return $res;
}

}
83 changes: 69 additions & 14 deletions src/Tbk/Dg/Client.php
View file
Original file line number Diff line number Diff line change
Expand Up @@ -20,7 +20,6 @@
*/
class Client extends BaseClient
{

/**
* taobao.tbk.dg.item.coupon.get (好券清单API【导购】)
* @line http://open.taobao.com/docs/api.htm?apiId=29821&docType=2
Expand All @@ -34,8 +33,8 @@ public function getCoupon(array $params)
}

/**
* taobao.tbk.dg.newuser.order.get (淘宝客新用户订单API--导购)
* @line http://open.taobao.com/docs/api.htm?apiId=33892&docType=2
* taobao.tbk.dg.newuser.order.get (淘宝客-推广者-新用户订单明细查询)
* @line https://open.taobao.com/api.htm?docId=33892&docType=2
* @param array $params
* @return array|mixed|\SimpleXMLElement|string
*/
Expand All @@ -46,8 +45,8 @@ public function getOrderNewUser(array $params)
}

/**
* taobao.tbk.dg.material.optional (通用物料搜索API（导购）)
* @line http://open.taobao.com/docs/api.htm?apiId=35896&docType=2
* taobao.tbk.dg.material.optional (淘宝客-推广者-物料搜索)
* @line https://open.taobao.com/api.htm?docId=35896&docType=2
* @param array $params
* @return array|mixed|\SimpleXMLElement|string
*/
Expand All @@ -58,8 +57,8 @@ public function materialOptional(array $params)
}

/**
* taobao.tbk.sc.newuser.order.sum (拉新活动汇总API--社交)
* @line http://open.taobao.com/docs/api.htm?apiId=36836&docType=2
* taobao.tbk.sc.newuser.order.sum (淘宝客-推广者-拉新活动对应数据查询)
* @line https://open.taobao.com/api.htm?docId=36836&docType=2
* @param array $params
* @return array|mixed|\SimpleXMLElement|string
*/
Expand All @@ -71,8 +70,8 @@ public function sumOrderNewUser(array $params)

/**
* 通用物料推荐，传入官方公布的物料id，可获取指定物料
* taobao.tbk.dg.optimus.material( 淘宝客物料下行-导购 )
* @line http://open.taobao.com/api.htm?docId=33947&docType=2
* taobao.tbk.dg.optimus.material( 淘宝客-推广者-物料精选 )
* @line https://open.taobao.com/api.htm?docId=33947&docType=2
* @param array $params
* @return array|mixed|\SimpleXMLElement|string
*/
Expand All @@ -83,9 +82,8 @@ public function materialOptimus(array $params)
}

/**
* 创建淘礼金
* taobao.tbk.dg.vegas.tlj.create( 淘礼金创建 )
* @line http://open.taobao.com/api.htm?docId=40173&docType=2
* taobao.tbk.dg.vegas.tlj.create( 淘宝客-推广者-淘礼金创建 )
* @line https://open.taobao.com/api.htm?docId=40173&docType=2
* @param array $params
* @return array|mixed|\SimpleXMLElement|string
*/
Expand All @@ -96,14 +94,71 @@ public function createTlj(array $params)
}

/**
* 处罚订单查询 -导购-私域用户管理专用
* taobao.tbk.dg.punish.order.get (淘宝客-推广者-处罚订单查询)
* @line https://open.taobao.com/api.htm?docId=42050&docType=2
* @param array $params
* @return array|mixed|\SimpleXMLElement|string
*/
public function getPunishOrder(array $params)
{
$res = $this->httpPost('taobao.tbk.dg.punish.order.get', $params);
if (isset($params['af_order_option']) && is_array($params['af_order_option'])) {
$data['af_order_option'] = json_encode($params['af_order_option']);
} elseif (is_array($params)) {
$data['af_order_option'] = json_encode($params);
} else {
$data['af_order_option'] = $params;
}
$res = $this->httpPost('taobao.tbk.dg.punish.order.get', $data);
return $res;
}

/**
* taobao.tbk.dg.vegas.tlj.instance.report (淘宝客-推广者-淘礼金发放及使用报表)
* @link https://open.taobao.com/api.htm?docId=43317&docType=2
* @param array $params
* @return array|mixed|\SimpleXMLElement|string
*/
public function getTljReport(array $params)
{
$res = $this->httpPost('taobao.tbk.dg.vegas.tlj.instance.report', $params);
return $res;
}

/**
* taobao.tbk.dg.wish.update (媒体导购单选品)
* @link https://open.taobao.com/api.htm?docId=46750&docType=2
* @param array $params
* @return array|mixed|\SimpleXMLElement|string
*/
public function updateWish(array $params)
{
if (isset($params['param0']) && is_array($params['param0'])) {
$data['param0'] = json_encode($params['param0']);
} elseif (is_array($params)) {
$data['param0'] = json_encode($params);
} else {
$data['param0'] = $params;
}
$res = $this->httpPost('taobao.tbk.dg.wish.update', $data);
return $res;
}

/**
* taobao.tbk.dg.wish.list( 媒体淘客导购单查询 )
* @link https://open.taobao.com/api.htm?docId=46751&docType=2
* @param array $params
* @return array|mixed|\SimpleXMLElement|string
*/
public function getWishList(array $params)
{
if (isset($params['param0']) && is_array($params['param0'])) {
$data['param0'] = json_encode($params['param0']);
} elseif (is_array($params)) {
$data['param0'] = json_encode($params);
} else {
$data['param0'] = $params;
}
$res = $this->httpPost('taobao.tbk.dg.wish.list', $data);
return $res;
}
}
16 changes: 8 additions & 8 deletions src/Tbk/Item/Client.php
View file
Original file line number Diff line number Diff line change
Expand Up @@ -34,8 +34,8 @@ public function get(array $params)
}

/**
* taobao.tbk.item.convert (淘宝客商品链接转换)
* @line http://open.taobao.com/docs/api.htm?apiId=24516&docType=2
* taobao.tbk.item.convert (淘宝客-推广者-商品链接转换)
* @line https://open.taobao.com/api.htm?docId=24516&docType=2
* @param array $params
* @return array|mixed|\SimpleXMLElement|string
*/
Expand All @@ -46,8 +46,8 @@ public function convert(array $params)
}

/**
* taobao.tbk.item.recommend.get (淘宝客商品关联推荐查询)
* @line http://open.taobao.com/docs/api.htm?apiId=24517&docType=2
* taobao.tbk.item.recommend.get (淘宝客-公用-商品关联推荐)
* @line https://open.taobao.com/api.htm?docId=24517&docType=2
* @param array $params
* @return array|mixed|\SimpleXMLElement|string
*/
Expand All @@ -58,8 +58,8 @@ public function getRecommend(array $params)
}

/**
* taobao.tbk.item.info.get (淘宝客商品详情（简版）)
* @line http://open.taobao.com/docs/api.htm?apiId=24518&docType=2
* taobao.tbk.item.info.get (淘宝客-公用-淘宝客商品详情查询(简版))
* @line https://open.taobao.com/api.htm?docId=24518&docType=2
* @param array $params
* @return array|mixed|\SimpleXMLElement|string
*/
Expand All @@ -83,8 +83,8 @@ public function likeGuess(array $params)

/**
* 从长链接或短链接中解析出open_iid
* taobao.tbk.item.click.extract( 链接解析api )
* @line http://open.taobao.com/api.htm?docId=28156&docType=2
* taobao.tbk.item.click.extract(淘宝客-公用-链接解析出商品id)
* @line https://open.taobao.com/api.htm?docId=28156&docType=2
* @param array $params
* @return array|mixed|\SimpleXMLElement|string
*/
Expand Down
2 changes: 1 addition & 1 deletion src/Tbk/Ju/Client.php
View file
Original file line number Diff line number Diff line change
Expand Up @@ -23,7 +23,7 @@ class Client extends BaseClient

/**
* taobao.tbk.ju.tqg.get (淘抢购api)
* @line http://open.taobao.com/docs/api.htm?apiId=27543&docType=2
* @line https://open.taobao.com/api.htm?docId=27543&docType=2
* @param array $params
* @return array|mixed|\SimpleXMLElement|string
*/
Expand Down
Loading

0 comments on commit f3ff7c3

Please sign in to comment.