README.md 2.8 KB
Newer Older
李光春's avatar
李光春 已提交
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 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);

```