RestSharp基本使用方法

• 关于RestSharp

RestSharp is a library that allows you to make REST and HTTP calls in .NET applications. It supports serialization, parameters, async functions, and more.

RestSharp是C#的一个WepApi库，支持通用的Web接口处理，支持序列化、参数化、异步回调等。

• 入门示例，带授权的GET请求

// 设置授权信息Authenticator，客户端级别，适用于多个请求共用
// 指定主页(基)地址
var opt = new RestClientOptions(HomeUrl)
{
    Authenticator = new HttpBasicAuthenticator("用户名", "密码")
};
var client = new RestClient(opt);

// 创建请求，指定相对地址
var req = new RestRequest("ui/api/f1?recordNum=0");
// 也可以在请求上单独设置授权信息，单个请求的级别
// req.Authenticator = Authenticator;

// 在client上执行异步的GET请求
var ans = await client.GetAsync(req);
ShowRest(req, ans);

// 显示应答方法
void ShowRest(RestRequest req, RestResponse ans)
{
    if(ans.IsSuccessful)
    {
        Log("请求成功：\r\n链接:" + ans.ResponseUri.AbsoluteUri + "\r\n结果:" + ans.Content);
    }
    else
    {
        Log("请求失败：\r\n链接:" + (ans.ResponseUri?.AbsoluteUri ?? req.Resource) + "\r\n原因:" + ans.Content);
    }
}

• 一般流程，示例GET

// 1.创建client，指定基地址
var client = new RestClient('htpp://192.168.1.1:8089');
// 支持添加client级别的参数，如下:
// AddDefaultHeader
// AddDefaultHeaders
// AddDefaultParameter
// AddDefaultParameter
// AddDefaultParameter
// AddDefaultQueryParameter
// AddDefaultUrlSegment

// 2.创建请求，指定相对地址
var req = new RestRequest("/api/v1/ui/auth/f2");
// 设置参数
foreach(var p in Parameters)
{
    req.AddParameter(p.Key, p.Value);
}
// 参数还可以通过其他方式添加，如：
// req.AddBody("", ContentType.Json);
// req.AddObject(para)
// req.AddJsonBody(json_para);

// 3.添加授权信息（该步骤可选，看接口是否需要授权）
req.Authenticator = Authenticator;

// 其他参数设置,如:
// 添加Cookies AddCookie
// 添加Header  AddHeader
// 添加上传文件 AddFile

// 4.执行请求
// 请求方式支持：Get Post Put Delete Head Options Patch Merge Copy Search
var ans = client.Execute(req, Method.Get);
ShowRest(req, ans);

• POST + JSON 示例

// 1.创建client，指定基地址
var client = new RestClient(HomeUrl);

// 2.创建请求，指定相对地址
var req = new RestRequest("api/v1/f3");
// 设置参数
// {"path":"2024/202411121649.zip","name":"my_baby","type":"file"}
req.AddJsonBody(Para);

// 3.添加授权信息（该步骤可选，看接口是否需要授权）
req.Authenticator = Authenticator;

// 添加其他信息，指定使用JSON内容
req.AddHeader("X-Requested-With", "XMLHttpRequest");
req.AddHeader("Content-Type", "application/json");

// 4.执行请求
var ans = client.Execute(req, Method.Post);
ShowRest(req, ans);

• PUT 上传文件

// 1.创建client，指定基地址
var client = new RestClient(HomeUrl);

// 2.创建请求，指定相对地址
var filePath = Parameters["FilePath"];
var repoPath = Parameters["RepoPath"];
var req = new RestRequest("/artifactory/" + ReposName + "/" + repoPath);

// 设置上传的目标文件
req.AddFile(Path.GetFileName(filePath), filePath);

// 3.添加授权信息（该步骤可选，看接口是否需要授权）
req.Authenticator = Authenticator;

// 4.执行请求
var ans = client.Execute(req, Method.Put);
ShowRest(req, ans);