# QcloudSharp

**Repository Path**: JoyMoe/QcloudSharp

## Basic Information

- **Project Name**: QcloudSharp
- **Description**: 腾讯云 API 的非官方 .Net 封装

开源中国码云项目仅供访问 GitHub 不畅者临时查阅代码使用，Issue、PR 请移步 GitHub
- **Primary Language**: C#
- **License**: MIT
- **Default Branch**: master
- **Homepage**: https://github.com/JoyMoe/QcloudSharp
- **GVP Project**: No

## Statistics

- **Stars**: 20
- **Forks**: 7
- **Created**: 2016-11-01
- **Last Updated**: 2023-04-21

## Categories & Tags

**Categories**: web-dev-toolkits

**Tags**: None

## README

QcloudSharp: 腾讯云 API 的非官方 .Net 封装
===

[![AppVeyor](https://img.shields.io/appveyor/ci/JoyMoe/qcloudsharp.svg)](https://ci.appveyor.com/project/JoyMoe/qcloudsharp)
[![GitHub license](https://img.shields.io/badge/license-MIT-blue.svg)](https://raw.githubusercontent.com/JoyMoe/QcloudSmsSharp/master/LICENSE)
[![NuGet](https://img.shields.io/nuget/v/QcloudSharp.svg)](https://www.nuget.org/packages/QcloudSharp)
[![NuGet](https://img.shields.io/nuget/vpre/QcloudSharp.svg)](https://www.nuget.org/packages/QcloudSharp/absoluteLatest)
![net451](https://img.shields.io/badge/.Net-4.5.1-brightgreen.svg)
![net462](https://img.shields.io/badge/.Net-4.6.2-brightgreen.svg)
![netstandard1.5](https://img.shields.io/badge/.Net-netstandard1.5-brightgreen.svg)
![netstandard2.0](https://img.shields.io/badge/.Net-netstandard2.0-brightgreen.svg)

### 安装
在 Package Manager Console 中运行如下指令或使用 Nuget.
```powershell
PM> Install-Package QcloudSharp
```

### 范例
```csharp
using QcloudSharp;
using Newtonsoft.Json;

dynamic client = new QcloudClient
{
    SecretId = "Your_Secret_Id",
    SecretKey = "Your_Secret_Key",
    Endpoint = Constants.Endpoint.Trade, // Endpoint 可被作为 Dynamic Methods 的第一个参数
    Region = Constants.Region.CAN, // Region 可被作为 Dynamic Methods 的第一个或第二个参数
};

var resultString = client.DescribeUserInfo();
// 预期返回值 {"code":0,"message": "","userInfo":{"name":"compName","isOwner":1,"mailStatus":1,"mail":"112233@qq.com","phone":"13811112222"}}

dynamic result = JsonConvert.DeserializeObject<ApiResult>(resultString);

try
{
    Console.WriteLine(result.Code);
    Console.WriteLine(result.userInfo.name);
    Console.WriteLine(result.notExist);
}
catch(Exception ex)
{
    Console.WriteLine(ex.message);
}
```

更多细节可查看 [sample](sample) 项目.

### 常数

所有常数由 `QcloudSharp.Constants` 类提供.

```csharp
public static class Endpoint // API 端点
```

成员
* Account
* Bill
* Bm
* Cbs
* Cdb
* Cdn
* Cmem
* CmqQueue
* CmqTopic
* Cns
* Csec
* Cvm
* Dayu
* Dfw
* Eip
* Image
* Iot
* Kms
* Lb
* Live
* Market
* Mongodb
* Monitor
* Partners
* Redis
* Scaling
* Snapshot
* Sqlserver
* Tdsql
* Tmt
* Trade
* Vod
* Vod2
* Vpc
* Wenzhi
* Wss
* Yunsou

```csharp
public static class Region // 区域（采用三位 IATA 城市编码）
```

成员
* BJS `北京`
* CAN `广州`
* HKG `香港`
* SHA `上海`
* SIN `新加坡`
* SJC `美国西部`
* YTO `加南大`
* CAN1 `广州开放`
* SHA2 `上海金融`
* SZX2 `深圳金融`

### 类

#### QcloudClient

```csharp
public class QcloudClient : DynamicObject
```

初始化
* `QcloudClient()`
* `QcloudClient(SecretId, SecretKey)`

属性
* string `SecretId`
* string `SecretKey`
* string `Region`
* string `Endpoint`

方法
* `void AddParameter(KeyValuePair<string, string>)`
* `void AddParameter(IEnumerable<KeyValuePair<string, string>>)`
* `void ClearParameter()`
* `Submit(string, string, string)`
* `Submit(string, string)`
* `Submit(string)`

动态方法
* `{Action}([string][, string][, IEnumerable<KeyValuePair<string, string>>])`
* `{Action}([string][, string][, KeyValuePair<string, string> ...])`

#### ApiResult

```csharp
public class ApiResult : DynamicObject
```

初始化
* `ApiResult()`

属性
* int `Code`
* string `Message`

动态属性
* object Any { Get; Set; }

## 授权

The MIT License

详见 [LICENSE](LICENSE).