.NET服務端SDK集成
更新時間:
IClientProfile是與阿里云驗證碼服務端API交互的接口,所有SDK的操作都需要通過IClientProfile完成。
前提條件
已為您的阿里云賬號創建AccessKey。
已從阿里云驗證碼控制臺下載.NET服務端SDK包。
服務端開發環境為.NET Framework 4.0或以上版本。
安裝SDK
在解壓的SDK包中,找到aliyun-net-sdk-afs.dll和aliyun-net-sdk-core.dll文件。
將這兩個文件導入您的服務端工程中。
例如,在Visual Studio中,右鍵單擊項目,選擇添加引用>瀏覽,選擇并添加這兩個DLL文件。
添加成功后,您就可以在您的服務端工程中使用阿里云驗證碼的.NET SDK。
注意事項
與阿里云驗證碼服務端SDK相關的類都在com.aliyuncs.IAcsClient包中。
SDK調用接口的默認連接超時時間是3秒,讀取超時時間是80秒。您可以調用帶有connectTimeout和readTimeout的構造方法來自定義設置SDK調用接口的連接超時時間和讀取超時時間。
初始化IClientProfile
IClientProfile支持復用,建議將其設置成應用程序全局唯一。
String regionid = "cn-hangzhou";
String accessKeyId = "*** Provide your AccessKeyId ***";
String accessKeySecret = "*** Provide your AccessKeySecret ***";
// Create a new IClientProfile instance
IClientProfile profile= DefaultProfile.getProfile(regionid, accessKeyId, accessKeySecret);
IAcsClient client = new DefaultAcsClient(profile);
DefaultProfile.addEndpoint("cn-hangzhou", "cn-hangzhou", "afs", "afs.aliyuncs.com");
調用阿里云驗證碼服務端API
初始化IClientProfile完成后,即可調用阿里云驗證碼服務端提供的API,根據業務需要開發前端頁面請求的處理類和對運行結果的處理方式。
關于阿里云驗證碼服務API的具體說明,請參見阿里云驗證碼Web/HTML5應用類型服務API。
public void Test()
{
AuthenticateSigRequest request = new AuthenticateSigRequest();
request.SessionId = "xxx";// 會話ID。必填參數,從前端獲取,不可更改。
request.Sig = "xxx";// 簽名串。必填參數,從前端獲取,不可更改。
request.Token = "xxx";// 請求唯一標識。必填參數,從前端獲取,不可更改。
request.Scene = "xxx";// 場景標識。必填參數,從前端獲取,不可更改。
request.AppKey = "xxx";// 應用類型標識。必填參數,后端填寫。
request.RemoteIp = "xxx";// 客戶端IP。必填參數,后端填寫。
try
{
//response的code枚舉:100驗簽通過,900驗簽失敗
AuthenticateSigResponse response = client.GetAcsResponse(request);
// TODO
}
catch (Exception e)
{
Console.WriteLine(e.ToString());
}
}
文檔內容是否對您有幫助?