yuanchao/pdd-union-php-sdk

pdd-union-php-sdk

v1.0 2020-02-03 03:59 UTC

This package is auto-updated.

Last update: 2024-11-29 06:21:50 UTC


README

  • 环境要求:php 5.5版本及以上,使用composer包管理工具
  • 执行一下 composer install 安装命令
  • 该SDK使用 composer 对src下面的代码进行命名空间自动导入,namespace 自动导入的规则是psr4 规范
  • 该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 针对某个特定的接口对应的示例代码

使用示例

用户授权

$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;

访问接口(以获取商品详情接口为例):

$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);