前言
支持.NET Core(2.0及以上)/.Net Framework(4.5及以上),可以部署在Docker, Windows, Linux, Mac。
http请求调用是开发中经常会用到的功能,因为,很多第三方功能接口往往是通过http地址的形式提供的,比如:ChatGpt、OpenAI、短信服务、在线翻译、地图服务、语音智能等等。.
正文
.NET 中调用http请求的工具很多,但本文介绍的这个,是相对使用"最简单+高效"的一个,在DeveloperSharp工具包中提供。
具体说明如下:http请求调用,又分为Post与Get两种形式。
Post形式的请求相对复杂一些,也更常用,一旦弄明白它 Get形式一看便懂,故我们首先来看看Post形式的请求调用。
使用Post调用http,往往有四个参数需要设置:
1、调用地址
2、需要发送过去的参数
3、http请求头(如果有设置)
4、编码格式,常用的为:application/json
下面给出一个使用第三方链接"发送短信”的代码示例:
using DeveloperSharp.Framework.CoreUtility; //从NuGet引用DeveloperSharp包
using Newtonsoft.Json; //从NuGet引用Newtonsoft.Json包
public static object iSoftStoneSync(string mobile, string code, string name)
{
//创建DeveloperSharp中的IUtility工具
IUtility IU = new Utility();
//调用地址
string requestUrl = "https://prekaka.rainfn.com/kaka/api/v1/activity/uploadUserData";
//需要发送的参数
Dictionary<string, object> data = new Dictionary<string, object>
{
{ "mobile",mobile },
{ "code",code},
{ "name",name}
};
//Post形式发送请求调用
var responsesStr = IU.HttpPost(requestUrl, JsonConvert.SerializeObject(data), null, "application/json");
object reData = JsonConvert.DeserializeObject<object>(responsesStr);
return reData;
}
上例因为没有设置"http请求头",故HttpPost方法的第三个参数传值为null。
HttpPost方法的详细说明如下:
HttpPost
声明:string HttpPost(string Url, string ParamData = "", Dictionary<string, string> HeaderDic = null, string ContentType = "application/x-www-form-urlencoded");
用途:调用Http-Post请求
参数:(1)string Url -- 调用请求的url地址
(2)string ParamData -- 提交的参数
(3)Dictionary<string, string> HeaderDic -- 存放http头的键值对
(4)string ContentType -- 请求的编码格式,通常有application/x-www-form-urlencoded(默认设置)、multipart/form-data、application/json三种形式
返回:String -- 请求结果(-107开头表示出错)
最后,我们来说说Get形式的请求调用。
Get形式往往用于url后带问号“?N1=V1&N2=V2&N3=V3”这类的调用。这类调用的特点是:“需要发送的参数”直接挂在了“调用地址”后面。下面直接给出一个示例,你一看便知:
using DeveloperSharp.Framework.CoreUtility; //从NuGet引用DeveloperSharp包
IUtility ui = new Utility();
string r = ui.HttpGet("http://localhost:1416/Handler1.ashx?name=kyyk&age=100");
总结
最后说明一点,以上调用方法为同步模式,因为绝大多数程序是要依赖拿到的http调用结果返回值才能继续往下执行的。
但若遇到少数异步的情况,可自行用aynsc/await/Task包装一下就行。