PHP SDK使用说明文档
1) 搭建PHP开发环境
i. 目前PHP SDK支持PHP 5.3.0以及以上版本
ii. PHP开启openssl拓展、curl扩展:打开php.ini,开启extension=php_openssl.dll、extension=php_curl.dll
2)调用PHP SDK
i. 在选择服务和相应的开发语言后点击“SDK下载”按钮来下载SDK工具包。将下载的PHP的SDK工具包进行解压,解压后如图所示。
此工具包集成了应用开发相关接口,核心是“Apis”目录下的php文件,和demo目录下的调用示例。接口文档在“doc”目录下的md文件中,文档中对各api接口的请求参数进行了详细的说明;
ii. 将apis文件添加至项目中,然后根据您的需求,可以参考demo目录下的调用示例,调用示例中给出了不同功能调用各个接口的代码示范,供使用者参考,或者直接引入自身的开发代码中。
以“查询设备”为例,其所需的参数如下所示。其中,appKey即您的App Key,appSecret为对应的App Secret,Appkey和AppSecret的获取请查看相关应用的详情界面。MasterKey和productId分别对应Master-APIkey和产品ID,可以从“设备管理”中的“产品”详情界面获取,deviceId为设备ID,可以从“设备”详情界面获取。其余的参数可以按照具体需求进行赋值。
public static function QueryDevice($appKey, $appSecret, $MasterKey, $deviceId, $productId)
{
$path="/aep_device_management/device";
$headers=array();
$headers["MasterKey"]=$MasterKey;
$param=array();
$param["deviceId"]=$deviceId;
$param["productId"]=$productId;
$version ="20181031202139";
$application=$appKey;
$secret=$appSecret;
$response = AepSdkCore::sendSDkRequest($path, $headers, $param, null, $version, $application, $secret, "GET");
if ($response != null){
return $response;
}
return null;
}
调用示例如下所示,供使用者参考,或者直接引入自身的开发代码中。
应用接入域名地址:*.api.ctwing.cn客户级域名只支持https调用(*为租户id),TLS版本只支持1.2
<?php
require_once dirname(__DIR__) . '\Apis\Aep_device_management.php';
class Aep_device_management_Demo
{
public static function Demo(){
$result=null;
$result = Aep_device_management::QueryDevice("appKey ", " appSecret ", " MasterKey ", " deviceId ", " productId ");
echo("result = " . $result. "\n");
}
}
Aep_device_management_Demo::Demo();
iii.专网用户调用
如果您是专网用户,则需要您在调用时,修改baseUrl、timeUrl两处地址,位置为Apis-Core- AepSdkCore.php文件,若专网地址为:55.255.46.9:10000,示例代码如下:
<?php
namespace AepSdk\Apis\Core;
use Exception;
class AepSdkCore
{
public static $baseUrl="http://55.255.46.9:10000";
public static $timeUrl ="http://55.255.46.9:10000/echo";
……
……
}