第二版SDK的一些新特性.docVIP

第二版SDK的一些新特性 采用了新浪官方主推的OAuth2.0进行授权和认证 所有接口都升级到了官方V2版的API，也就是说可以用官方V2版的API机型操作了 参考了官方PHP版的SDK，将授权认证的方法和API操作的方法独立成了两个类，逻辑上更清晰了 使用方法 第一步：授权认证 传统方式（适用于Web项目） 初始化OAuth类 获取Authorize地址 访问Authorize地址并进行授权，取得code 使用OAuth类的GetAccessTokenByAuthorizationCode方法获得AccessToken 完成 模拟登录方式（适用于Winform项目和其他项目类型） 初始化OAuth类 调用OAuth类中的ClientLogin方法，传入账号、密码以及绑定回调地址（ClientLogin方法模拟了上述整个授权过程，实现了一件登录和授权） 完成 第二步：实例化操作类 至此，授权完成了。接下来用刚才的OAuth作为参数来实例化一个Client操作类。 Client实例化以后，通过API命名空间，即可调用各种方法。 简单的使用案例 基于正常的授权认证流程 //初始化oAuth，准备认证 var oauth = new NetDimension.Weibo.OAuth(1028898141, 78be07c9bcfa30b7871788d3778ce131); /* * 正常的流程或Web流程： * 1. 获取授权地址 * 2. 访问授权地址 * 3. 授权成功后自动跳转至callback指定的网站，并获得code * 4. 通过code换取access token */ var url = oauth.GetAuthorizeURL(/oauth2/default.html, ResponseType.Code);//根据授权方法，获得授权地址。 System.Diagnostics.Process.Start(url);//模拟弹窗，Console方式直接打开了浏览器，Web项目可以根据需求来使用iframe、新窗口等打开此页面。 //打开浏览器，进行授权流程，之后会跳转到callback指定的网址，并获得code //填写刚才得到的code Console.Write(请填写浏览器地址中的Code参数：); var code = Console.ReadLine(); //根据code获取AccessToken var accessToken = oauth.GetAccessTokenByAuthorizationCode(code, /oauth2/default.html);//注意：callback指定的url必须一致 //看看我们获得的access token Console.WriteLine(accessToken); //至此，我们已经获得了AccessToken 使用简化流程之后的ClientLogin方法 //初始化oAuth，准备认证 var oauth = new NetDimension.Weibo.OAuth(1028898141, 78be07c9bcfa30b7871788d3778ce131); //简化的认证流程，直接调用ClientLogin。这个方法不需要去申请password方式的认证，只是模拟了上面的步骤并进行了封装 var result = oauth.ClientLogin(你的微博账号, 你的微博地址, /oauth2/default.html); //返回值为bool型，为true则表示授权、登录成功。为false的话，要不密码错了，要不就是回调地址和新浪后台里面填写的不一样 Console.WriteLine(oauth.AccessToken); //看看这里获得的AccessToken，理论上应该是和上面那种方法获得的Token一样。 接口调用示例 在上面的步骤中获得AccessToken后，直接将OAuth对象作为参数来实例化一个操作类Client实例。之后的事情，你懂的^_^ //实例化一个操作类，用刚才成功获得了AccessToken的OAuth实例 NetDimension.Weibo.Client Sina = new NetDimension.Weibo.Client(oauth); //调用各种方法吧 Console.WriteLine(Sina.API.Statuses.FriendsTimeline());//获取最新微博 Console.WriteLine(Sina.API.Statuses.Update(发布一条微博来测试下火力！ + DateTime.Now.ToLongTimeString())