.NET服务端SDK集成

前提条件

• 已为您的阿里云账号创建AccessKey。详细操作指导请参见创建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是与阿里云验证码服务端交互的接口，所有SDK的操作都需要通过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");

调用阿里云验证码服务端接口

IClientProfile完成后，即可调用AnalyzeNvcRequest接口，根据业务需要开发前端页面请求的处理类和对运行结果的处理方式。

public void Test()
{
    AnalyzeNvcRequest request = new AnalyzeNvcRequest();
    request.Data = "xxx";//必填参数，由前端获取getNVCVal方法获得的值。
    //通过setScoreJsonStr方法声明"服务端调用阿里云验证码接口得到的返回结果"与"前端执行操作"间的映射关系，并通知验证码服务端进行二次验证授权。
    //注意：前端页面必须严格按照该映射关系执行相应操作，否则将导致调用异常。
    //例如，在setScoreJsonStr方法中声明"400":"NC"，则当服务端返回400时，您的前端必须唤醒滑动验证（SC），如果唤醒其他验证，则将导致失败。
    request.ScoreJsonStr("{\"200\":\"PASS\",\"400\":\"NC\",\"800\":\"BLOCK\"}");//根据业务需求设置各返回结果对应的客户端处置方式。
    try
    {
        AnalyzeNvcResponse response = client.GetAcsResponse(request);
        // TODO
    }
    catch (Exception e)
    {
        Console.WriteLine(e.ToString());
    }
}