全部产品

.NET服务端SDK集成

更新时间:2021-03-28 21:06:51

IClientProfile是与阿里云验证码服务端API交互的接口,所有SDK的操作都需要通过IClientProfile完成。

前提条件

  • 已为您的阿里云账号创建AccessKey。

  • 已从阿里云验证码控制台下载.NET服务端SDK包。

  • 服务端开发环境为.NET Framework 4.0或以上版本。

安装SDK

  1. 在解压的SDK包中,找到aliyun-net-sdk-afs.dll和aliyun-net-sdk-core.dll文件。

  2. 将这两个文件导入您的服务端工程中。

    例如,在Visual Studio中,右键单击项目,选择添加引用>浏览,选择并添加这两个dll文件。

  3. 添加成功后,您就可以在您的服务端工程中使用阿里云验证码的.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());
          }
      }