C# SDK使用说明
1)搭建C#开发环境
i. 安装.NET Framework 4.0及以上版本(如果您已安装,请忽略此步骤),另外,您也可以通过访问.NET官网进行下载安装;
ii. 安装Visual Studio 2010 及以上版本(如果您已安装,请忽略此步骤),另外,您也可以通过访问 Microsoft Visual Studio 官网进行下载安装;
2)调用C# SDK
i. 在选择服务和相应的开发语言后点击“SDK下载”按钮来下载SDK工具包。将下载的C#的SDK工具包进行解压,解压后如图所示。
此工具包集成了应用开发相关接口,核心是Apis目录下的.cs文件,和Demo目录下的调用示例。接口文档在“doc”目录下的md文件中,文档中对各api接口的请求参数进行了详细的说明;
ii. 将apis文件添加至项目中,然后根据您的需求,可以参考demo目录下的调用示例,调用示例中给出了不同功能调用各个接口的代码示范,供使用者参考,或者直接引入自身的开发代码中。
以查询设备列表为例,其所需的参数如下所示,其中appKey即您的App Key,appSecret为对应的App Secret,Appkey和AppSecret的获取请查看相关应用的详情界面。MasterKey和productId分别对应Master-APIkey和产品ID,可以从产品中心中的产品详情界面获取。其余的参数可以按照具体需求进行赋值。
public static string QueryDeviceList(string appKey, string appSecret, string MasterKey, string productId, string searchValue = "", string pageNow = "", string pageSize = "") { string path = "/aep_device_management/devices"; Dictionary<string, string> headers = new Dictionary<string, string>(); headers.Add("MasterKey", MasterKey); Dictionary<string, string> param = new Dictionary<string, string>(); param.Add("productId", productId); param.Add("searchValue", searchValue); param.Add("pageNow", pageNow); param.Add("pageSize", pageSize); string version = "20190507012134"; string application = appKey; string key = appSecret; string response = AepHttpRequest.SendAepHttpRequest(path, headers, param, null, version, application, key, "GET"); if (response != null) return response; return null; }
调用示例如下所示,供使用者参考,或者直接引入自身的开发代码中。
using AepSdk.Apis; using System; namespace AepSdk.Demo { class Aep_device_management_Demo { public static void Demo() { string result = null; result = Aep_device_management.QueryDeviceList('appKey', 'appSecret', 'MasterKey', productId, searchValue, pageNow, pageSize); Console.WriteLine("result = " + result); } } }
注:如果调用SDK时出现报错,建议您参考在线文档中的API异常排查进行在线调试。
这篇文档是否帮助您解决了问题?