ddjbcid/sdk

pdd-ddjb SDK for PHP

1.0 2023-05-18 03:53 UTC

Requires

• php: ^5.5|^7.0
• ext-curl: *
• ext-json: *

MIT

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