# DNS.OpenSDK

**Repository Path**: master-zhou/OpenSDK

## Basic Information

- **Project Name**: DNS.OpenSDK
- **Description**: 直接操作各种开放平台的 SDK 
- **Primary Language**: C#
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 5
- **Forks**: 0
- **Created**: 2017-12-04
- **Last Updated**: 2020-12-19

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

## DotNetStar.OpenSDK
是一个开源的、轻便型、易扩展并集成各大开放平台的 SDK，不仅可以直接使用，还可以根据自己的需要快速定制符合自己需求的 SDK。

## 特点
* 完全即可使用，无须任何配置；
* 独创路径导航法，无须查阅文档就可以知道在哪使用；
* 采用强类型参数和返回值，无须思考就可以知道有哪些内容；
* 扩展自己的 SDK 只需要2步，上手难度几乎为零；
* 支持异步，提升性能，支持并发；
* 支持 .NET Framework 4.6.1+/.NET Core 2.0+/.NET Standard 2.0+

#### 必须使用 VS2017 打开项目，并装好 .NET Core 2.0 的 SDK。

## 在线安装(v1.0)
> Install-Package DNS.OpenSDK -version 1.0

## 路径导航
![](root1.png)
![](root2.png)
![](root3.png)


## 示例

* QQ 互联

	```cs
	OAuthConfig config = new OAuthConfig("appId", "appKey", "回调地址 url");
	
	//生成 qq 登录的链接
	var link = SDK.Use.QQConnect().GenerateAuthorizeCodeUrl(new QQAuthorizeCodeApiRequest(config));
	
	var code = "获得的 code";
	var response = await SDK.Use.QQConnect().GetAccessTokenAsync(config, code);
	//直接使用属性即可获得 access_token
	// response.Access_Token 
	// response.Expires_In
	// response.Refresh_Token
	```
* 微信登录

	```cs
	OAuthConfig config = new OAuthConfig("appId", "appKey", "授权回调地址");
	//生成微信登录的二维码 url
	SDK.Use.WeChat().GenerateWeChatQrCodeAuthorizeLink(new WeChatQrCodeAuthorizeCodeApiRequest(config));

	//生成在微信客户端进行登录的链接 url
	SDK.Use.WeChat().GenerateWeChatAuthorizeLink(new WeChatAuthorizeCodeApiRequest(config))
	```
* 微信公众号
	
	```cs
	//获取微信公众号的用户信息
	SDK.Use.WeChat().MP().GetUserInfoAsync(new UserInfoApiRequest(accessToken, openId))
	```
* 微信支付

	```cs
	PaymentConfig config = new PaymentConfig("appId", "商户号", "密钥");
	SDK.Use.WeChat().Pay().UnifiedOrderAsync(new UnifiedOrderApiRequest(config)
    {
        Out_Trade_No = orderNo,
        Spbill_Create_Ip = "1.2.3.4",
        Body = "test",
        Total_Fee = 15000,
        Notify_Url = "http://abc",
        Trade_Type = TradeTypes.NATIVE
    })
	```

# [如何开始？](https://gitee.com/DotNetStar/OpenSDK/wikis/%E5%BF%AB%E9%80%9F%E4%BD%BF%E7%94%A8)

# [用的不爽的点这里！！](https://gitee.com/DotNetStar/OpenSDK/issues)

## SDK 已集成的开放平台和 api 列表(v1.0)
* QQ互联（QQConnect）[官网](http://connect.qq.com)
	* 生成 QQ 登录的 url（GenerateAuthorizeCodeUrl）
	* 获取 access_token （GetAccessTokenAsync）
	* 获取 OpenId （GetOpenIdAsync）
	* 获取用户在QQ空间的个人信息（GetUserInfoAsync）
	* 获取QQ会员的基本信息（GetVipInfoAsync）
	* 获取QQ会员的高级信息（GetVipRichInfoAsync）
	* 获取QQ空间的相册列表（GetAlbumListAsync）
	* 获取QQ空间指定的相册照片列表（GetAlbumPhotoListAsync）
* 微信（WeChat）
	* 开放平台（Open）[官网](http://open.weixin.qq.com)
		* 生成可以再网页端进行微信登录的二维码链接（GenerateWeChatQrCodeAuthorizeLink）
		* 生成可在微信客户端进行登录授权的 url 链接（GenerateWeChatAuthorizeLink）
		* 获取微信应用的 access_token（GetClientAccessTokenAsync）
		* 获取微信的 access_token （GetAccessTokenAsync）
		* 刷新 access token 令牌（RefreshAccessTokenAsync）
	* 公众号（MP）[官网](http://mp.weixin.qq.com)
		* 获取微信服务器的 Ip 列表（GetIpListAsync）
		* 获取指定用户的信息（GetUserInfoAsync）
		* 获取关注公众号的用户列表（GetUserListAsync）
		* 生成带参数的二维码（GenerateQrCodeAsync）
		* 将指定的长链接转换成短链接（ToShortUrlAsync）
	* 支付（Pay）[官网](http://pay.weixin.qq.com)
		* 统一下单（UnifiedOrderAsync）
		* 订单查询（OrderQueryAsync）
		* 关闭订单（CloseOrderAsync）
		* 申请退款（RefundAsync）
		* 退款查询（RefundQueryAsync）


## MIT
* 请符合 MIT 协议并保留原作者版权；
* 你必须在你的发行版里包含原许可协议的声明；


**Copyright © 周大侠 2017-2018**