.NET 中最简单的http请求调用 (比如调用chatgpt的openAI接口)

前言

支持.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包装一下就行。