- 优化淘宝官方SDK

Author: dtapps

CHANGELOG.md

@@ -1,3 +1,6 @@
+## v6.0.126 / 2020-11-19
+- 优化淘宝官方SDK
+
 ## v6.0.125 / 2020-11-19
 - 优化淘宝服务协议
 

composer.json

@@ -47,7 +47,8 @@
   },
   "autoload": {
     "files": [
-      "src/common.php"
+      "src/common.php",
+      "src/service/taobao/bin/TopSdk.php"
     ],
     "psr-4": {
       "DtApp\\ThinkLibrary\\": "src"

src/common.php

@@ -25,7 +25,7 @@
 /**
  * 定义当前版本
  */
-const VERSION = '6.0.125';
+const VERSION = '6.0.126';
 
 if (!function_exists('get_ip_info')) {
     /**

src/service/pinduoduo/bin/README.md

@@ -0,0 +1,90 @@
+## 拼多多开放平台PHP版本的SDK
+- 环境要求：php 5.5版本及以上，使用composer包管理工具
+- 执行一下 composer install 安装命令
+- 该SDK使用 composer 对src下面的代码进行命名空间自动导入，namespace 自动导入的规则是[psr4 规范](https://www.php-fig.org/psr/psr-4/)
+- 该SDK共有2个文件夹，src文件夹下面是sdk主功能文件夹。example文件夹下面是所有接口的demo，作为测试样例参考。
+
+## src文件夹下面文件功能说明
+* PopAccessTokenClient 类
+	- generate : 根据从授权后回调地址那里拿到的code 值，然后去服务器获取access_token和refresh_token以及过期时间等值
+	- refresh：由于access_token时效性是24小时，refresh_token的时效性是30天，所以，当acces_token过期后，利用refresh_token进行重新获取access_token
+* PopHttpClient 类
+	- syncInvoke : 把接口名称 type 以及各自接口对应的业务参数，access_token(如果需要授权)传给这个接口即可获取到对应接口的返回值。
+* Api/Request
+	- 这个文件夹下面存放所有接口的自定义请求Request类
+* Common
+	- 这个文件夹下面存放所有的公共功能类
+* Token
+	- 这个文件夹下面存放获取和刷新token相关接口的request
+
+## example 文件夹说明
+
+* AccessToken.php 获取 access_token 的示例代码
+* Config_sample.php 使用的时候文件重命名为Config.php，替换文件里面的配置信息
+* PddXXXX.php 针对某个特定的接口对应的示例代码
+
+## 使用示例
+### 用户授权
+```php
+$clientId = "your app clientId";
+$clientSecret = "your app clientSecret";
+$refreshToken = "your app refreshToken";
+$code = "your code";
+
+ 
+$accessTokenClient = new PopAccessTokenClient($clientId,$clientSecret);
+
+ 
+// 生成AccessToken
+
+$result = $accessTokenClient->generate($code);
+$result = json_encode($result->getContent(),JSON_UNESCAPED_UNICODE);
+echo $result;
+
+ 
+
+// 刷新AccessToken
+
+$result = $accessTokenClient->refresh($refreshToken);
+$result = json_encode($result->getContent(),JSON_UNESCAPED_UNICODE);
+echo $result;
+
+```
+
+### 访问接口（以获取商品详情接口为例）：
+
+```php
+
+$clientId = "your app clientId";
+$clientSecret = "your app clientSecret";
+$pid = "your pid";
+
+//创建client客户端
+$client = new PopHttpClient($clientId, $clientSecret);
+
+//创建请求对象
+$request = new PddDdkGoodsDetailRequest();
+$request->setGoodsIdList(array(6730722720));
+$request->setPid($pid);
+$request->setCustomParameters('str');
+$request->setZsDuoId(1111111);
+$request->setPlanType(1);
+
+//发起接口请求
+try{
+	$response = $client->syncInvoke($request);
+} catch(Com\Pdd\Pop\Sdk\PopHttpException $e){
+	echo $e->getMessage();
+	exit;
+}
+
+$content = $response->getContent();
+
+//判断是否异常
+if(isset($content['error_response'])){
+	echo "异常返回";
+}
+echo json_encode($content,JSON_UNESCAPED_UNICODE);
+
+```
+

src/service/pinduoduo/bin/composer.json

@@ -0,0 +1,18 @@
+{
+    "require": {
+        "php": "^5.5|^7.0",
+        "ext-curl": "*",
+        "ext-json": "*"
+    },
+    "repositories": {
+        "packagist": {
+            "type": "composer",
+            "url": "https://mirrors.aliyun.com/composer/"
+        }
+    },
+    "autoload": {
+        "psr-4": {
+            "Com\\Pdd\\Pop\\Sdk\\": "src/"
+        }
+    }
+}

src/service/pinduoduo/bin/example/AccessToken.php

@@ -0,0 +1,24 @@
+<?php
+//多多客授权：https://jinbao.pinduoduo.com/open.html?client_id=$client_id&response_type=code&redirect_uri=https://hanshan.com
+require_once dirname(__FILE__).'/Config.php';
+require_once dirname(__FILE__)."/../vendor/autoload.php";
+
+use Com\Pdd\Pop\Sdk\PopAccessTokenClient;
+
+
+$clientId = Config::$clientId;
+$clientSecret = Config::$clientSecret;
+$client = new PopAccessTokenClient($clientId, $clientSecret);
+
+$code = Config::$code;//通过授权获取
+$result = $client->generate($code);
+$result = json_encode($result->getContent(),JSON_UNESCAPED_UNICODE);
+echo $result;
+die();
+
+$result = $client->refresh(Config::$refreshToken);
+$result = json_encode($result->getContent(),JSON_UNESCAPED_UNICODE);
+echo $result;
+
+
+

src/service/pinduoduo/bin/example/Config_sample.php

@@ -0,0 +1,10 @@
+<?php
+
+class Config
+{
+    static public $clientId = "Your client id";
+    static public $clientSecret = "Your client secret";
+    static public $accessToken ="Your access token";
+    static public $refreshToken = "Your refresh token";
+    static public $code = "Your code";
+}

src/service/pinduoduo/bin/example/PddAdApiAdvertiserOpenAccount.php

@@ -0,0 +1,24 @@
+<?php
+/**
+ * 示例接口名称：pdd.ad.api.advertiser.open.account
+*/
+require_once dirname(__FILE__).'/Config.php';
+require_once dirname(__FILE__)."/../vendor/autoload.php";
+
+use Com\Pdd\Pop\Sdk\PopHttpClient;
+use Com\Pdd\Pop\Sdk\Api\Request\PddAdApiAdvertiserOpenAccountRequest;
+$client = new PopHttpClient(Config::$clientId, Config::$clientSecret);
+
+$request = new PddAdApiAdvertiserOpenAccountRequest();
+
+try{
+	$response = $client->syncInvoke($request);
+} catch(Com\Pdd\Pop\Sdk\PopHttpException $e){
+	echo $e->getMessage();
+	exit;
+}
+$content = $response->getContent();
+if(isset($content['error_response'])){
+	echo "异常返回";
+}
+echo json_encode($content,JSON_UNESCAPED_UNICODE);

src/service/pinduoduo/bin/example/PddAdApiAdvertiserQueryAccountBalance.php

@@ -0,0 +1,24 @@
+<?php
+/**
+ * 示例接口名称：pdd.ad.api.advertiser.query.account.balance
+*/
+require_once dirname(__FILE__).'/Config.php';
+require_once dirname(__FILE__)."/../vendor/autoload.php";
+
+use Com\Pdd\Pop\Sdk\PopHttpClient;
+use Com\Pdd\Pop\Sdk\Api\Request\PddAdApiAdvertiserQueryAccountBalanceRequest;
+$client = new PopHttpClient(Config::$clientId, Config::$clientSecret);
+
+$request = new PddAdApiAdvertiserQueryAccountBalanceRequest();
+
+try{
+	$response = $client->syncInvoke($request);
+} catch(Com\Pdd\Pop\Sdk\PopHttpException $e){
+	echo $e->getMessage();
+	exit;
+}
+$content = $response->getContent();
+if(isset($content['error_response'])){
+	echo "异常返回";
+}
+echo json_encode($content,JSON_UNESCAPED_UNICODE);

src/service/pinduoduo/bin/example/PddAdApiAdvertiserQueryAccountInfo.php

@@ -0,0 +1,24 @@
+<?php
+/**
+ * 示例接口名称：pdd.ad.api.advertiser.query.account.info
+*/
+require_once dirname(__FILE__).'/Config.php';
+require_once dirname(__FILE__)."/../vendor/autoload.php";
+
+use Com\Pdd\Pop\Sdk\PopHttpClient;
+use Com\Pdd\Pop\Sdk\Api\Request\PddAdApiAdvertiserQueryAccountInfoRequest;
+$client = new PopHttpClient(Config::$clientId, Config::$clientSecret);
+
+$request = new PddAdApiAdvertiserQueryAccountInfoRequest();
+
+try{
+	$response = $client->syncInvoke($request);
+} catch(Com\Pdd\Pop\Sdk\PopHttpException $e){
+	echo $e->getMessage();
+	exit;
+}
+$content = $response->getContent();
+if(isset($content['error_response'])){
+	echo "异常返回";
+}
+echo json_encode($content,JSON_UNESCAPED_UNICODE);

src/service/pinduoduo/bin/example/PddAdApiAdvertiserQueryDetail.php

@@ -0,0 +1,24 @@
+<?php
+/**
+ * 示例接口名称：pdd.ad.api.advertiser.query.detail
+*/
+require_once dirname(__FILE__).'/Config.php';
+require_once dirname(__FILE__)."/../vendor/autoload.php";
+
+use Com\Pdd\Pop\Sdk\PopHttpClient;
+use Com\Pdd\Pop\Sdk\Api\Request\PddAdApiAdvertiserQueryDetailRequest;
+$client = new PopHttpClient(Config::$clientId, Config::$clientSecret);
+
+$request = new PddAdApiAdvertiserQueryDetailRequest();
+
+try{
+	$response = $client->syncInvoke($request);
+} catch(Com\Pdd\Pop\Sdk\PopHttpException $e){
+	echo $e->getMessage();
+	exit;
+}
+$content = $response->getContent();
+if(isset($content['error_response'])){
+	echo "异常返回";
+}
+echo json_encode($content,JSON_UNESCAPED_UNICODE);

src/service/pinduoduo/bin/example/PddAdApiGoodsQueryGalleryImages.php

@@ -0,0 +1,25 @@
+<?php
+/**
+ * 示例接口名称：pdd.ad.api.goods.query.gallery.images
+*/
+require_once dirname(__FILE__).'/Config.php';
+require_once dirname(__FILE__)."/../vendor/autoload.php";
+
+use Com\Pdd\Pop\Sdk\PopHttpClient;
+use Com\Pdd\Pop\Sdk\Api\Request\PddAdApiGoodsQueryGalleryImagesRequest;
+$client = new PopHttpClient(Config::$clientId, Config::$clientSecret);
+
+$request = new PddAdApiGoodsQueryGalleryImagesRequest();
+
+$request->setGoodsId(1);
+try{
+	$response = $client->syncInvoke($request);
+} catch(Com\Pdd\Pop\Sdk\PopHttpException $e){
+	echo $e->getMessage();
+	exit;
+}
+$content = $response->getContent();
+if(isset($content['error_response'])){
+	echo "异常返回";
+}
+echo json_encode($content,JSON_UNESCAPED_UNICODE);

src/service/pinduoduo/bin/example/PddAdApiGoodsQueryLongImages.php

@@ -0,0 +1,25 @@
+<?php
+/**
+ * 示例接口名称：pdd.ad.api.goods.query.long.images
+*/
+require_once dirname(__FILE__).'/Config.php';
+require_once dirname(__FILE__)."/../vendor/autoload.php";
+
+use Com\Pdd\Pop\Sdk\PopHttpClient;
+use Com\Pdd\Pop\Sdk\Api\Request\PddAdApiGoodsQueryLongImagesRequest;
+$client = new PopHttpClient(Config::$clientId, Config::$clientSecret);
+
+$request = new PddAdApiGoodsQueryLongImagesRequest();
+
+$request->setGoodsId(1);
+try{
+	$response = $client->syncInvoke($request);
+} catch(Com\Pdd\Pop\Sdk\PopHttpException $e){
+	echo $e->getMessage();
+	exit;
+}
+$content = $response->getContent();
+if(isset($content['error_response'])){
+	echo "异常返回";
+}
+echo json_encode($content,JSON_UNESCAPED_UNICODE);

src/service/pinduoduo/bin/example/PddAdApiGoodsQueryPage.php

@@ -0,0 +1,28 @@
+<?php
+/**
+ * 示例接口名称：pdd.ad.api.goods.query.page
+*/
+require_once dirname(__FILE__).'/Config.php';
+require_once dirname(__FILE__)."/../vendor/autoload.php";
+
+use Com\Pdd\Pop\Sdk\PopHttpClient;
+use Com\Pdd\Pop\Sdk\Api\Request\PddAdApiGoodsQueryPageRequest;
+$client = new PopHttpClient(Config::$clientId, Config::$clientSecret);
+
+$request = new PddAdApiGoodsQueryPageRequest();
+
+$request->setGoodsName('str');
+$request->setPageNumber(1);
+$request->setPageSize(1);
+$request->setPlanId(1);
+try{
+	$response = $client->syncInvoke($request);
+} catch(Com\Pdd\Pop\Sdk\PopHttpException $e){
+	echo $e->getMessage();
+	exit;
+}
+$content = $response->getContent();
+if(isset($content['error_response'])){
+	echo "异常返回";
+}
+echo json_encode($content,JSON_UNESCAPED_UNICODE);

src/service/pinduoduo/bin/example/PddAdApiKeywordCreate.php

@@ -0,0 +1,26 @@
+<?php
+/**
+ * 示例接口名称：pdd.ad.api.keyword.create
+*/
+require_once dirname(__FILE__).'/Config.php';
+require_once dirname(__FILE__)."/../vendor/autoload.php";
+
+use Com\Pdd\Pop\Sdk\PopHttpClient;
+use Com\Pdd\Pop\Sdk\Api\Request\PddAdApiKeywordCreateRequest;
+$client = new PopHttpClient(Config::$clientId, Config::$clientSecret);
+
+$request = new PddAdApiKeywordCreateRequest();
+
+$request->setAdId(1);
+$request->setKeywordList();
+try{
+	$response = $client->syncInvoke($request);
+} catch(Com\Pdd\Pop\Sdk\PopHttpException $e){
+	echo $e->getMessage();
+	exit;
+}
+$content = $response->getContent();
+if(isset($content['error_response'])){
+	echo "异常返回";
+}
+echo json_encode($content,JSON_UNESCAPED_UNICODE);