本文介绍安装.NET SDK的教程。

创建AccessKey

  1. 访问安全信息管理页面并登录阿里云账号。
  2. 创建AccessKey。更多信息请参见创建AccessKey

安装SDK

  • 开发环境:阿里云.Net SDK支持framework 4.0或以上版本。
  • 安装步骤:
    1. 在解压的文件中可以找到aliyun-net-sdk-cf.dll和aliyun-net-sdk-core.dll这两个文件。
    2. 在你的Visual Studio项目上单击右键,选择添加引用>浏览(如果您使用的是MonoDevelop,请自行按照相应导入dll的方法导入dll文件)。
    3. 选择上述的dll文件,单击确定,经过以上步骤,您就可以在工程中使用阿里云.Net SDK了。

快速入门

初始化一个IClientProfile。

  1. 与阿里云SDK相关的类都在包com.aliyuncs.IAcsClient下。
  2. IClientProfile是与API交互的接口,SDK的操作都是通过IClientProfile完成的。
  3. IClientProfile可以复用,建议设置成应用程序全局唯一的。
  4. 用户可以调用带有connectTimeout和readTimeout的构造方法来设置SDK调用接口的连接超时时间和读取超时时间,SDK默认的连接超时时间是3秒,读取超时时间是80秒。
String regionid = "cn-hangzhou";
String accessKeyId = "*** Provide your AccessKeyId ***";
String accessKeySecret = "*** Provide your AccessKeySecret ***";

// Create a new IClientProfile instance
IClientProfile client = DefaultProfile.GetProfile(regionid, accessKeyId, accessKeySecret);			

示例代码

  • 风险识别API
public void Test()
        {
            SpamRegisterPreventionRequest request = new SpamRegisterPreventionRequest();
            // 必填参数
            request.PhoneNumber = "";
            request.Ip = "客户端来源IP";
            request.ProtocolVersion = "1.0.1";
            request.Source = 3; //注册来源。1:PC网页;2:移动网页;3:APP;4:其它。
            request.JsToken = ""; //对应前端页面的afs_token,source来源为1&2&4时,必填。
            request.SDKToken = "";//对应sdk中获取的wtoken,source来源为3时,必填。

            // 选填参数
            request.Email = "";
            request.UserId = "";
            request.IdType = 1;
            request.CurrentUrl = "";
            request.Agent = "";
            request.Cookie = "";
            request.SessionId = "";
            request.MacAddress = "";
            request.Referer = "";
            request.NickName = "";
            request.CompanyName = "";
            request.Address = "";
            request.IDNumber = "";
            request.BankCardNumber = "";
            request.ExtendData = "";

            try
            {
                SpamRegisterPreventionResponse response = client.GetAcsResponse(request);
                // TODO
            }
            catch (Exception e)
            {
                Console.WriteLine(e.ToString());
            }
        }
			
  • 风险拦截API
 public void Test()
        {
            AfsCheckRequest request = new AfsCheckRequest();
            request.Platform = 3;//必填参数,请求来源: 1:Android端;2:iOS端;3:PC端及其他
            request.Session = "xxx";// 必填参数,从前端获取,不可更改
            request.Sig = "xxx";// 必填参数,从前端获取,不可更改
            request.Token = "zxd";// 必填参数,从前端获取,不可更改
            request.Scene = "xxx";// 必填参数,从前端获取,不可更改

            try
            {
                AfsCheckResponse response = client.GetAcsResponse(request);
                // TODO
            }
            catch (Exception e)
            {
                Console.WriteLine(e.ToString());
            }
        }