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.

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

  • 入门示例,带授权的GET请求
C# 复制代码
// 设置授权信息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
C# 复制代码
// 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 示例
C# 复制代码
// 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 上传文件
C# 复制代码
// 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);
相关推荐
钢铁男儿2 分钟前
C# 委托(调用带引用参数的委托)
java·mysql·c#
泓博17 分钟前
Objective-c把字符解析成字典
开发语言·ios·objective-c
try2find20 分钟前
安装llama-cpp-python踩坑记
开发语言·python·llama
番茄小能手1 小时前
【全网唯一】C# 纯本地离线文字识别Windows版dll插件
开发语言·c#
梁诚斌1 小时前
使用OpenSSL接口读取pem编码格式文件中的证书
开发语言·c++
瓜子三百克1 小时前
Objective-C 路由表原理详解
开发语言·ios·objective-c
葬歌倾城2 小时前
waferMap图像渲染
c#·wpf
幽蓝计划2 小时前
HarmonyOS NEXT仓颉开发语言实战案例:外卖App
开发语言·harmonyos
伍哥的传说2 小时前
鸿蒙系统(HarmonyOS)应用开发之实现电子签名效果
开发语言·前端·华为·harmonyos·鸿蒙·鸿蒙系统
甄天2 小时前
WPF路由事件:冒泡、隧道与直接全解析
c#·wpf·visual studio