本文适用于具有一定c#语言基础的新手学习web api接口,主要从安装软件、编写程序到发布测试。
visual studio 2022、net.core8.0
web api 创建/发布/测试
一、下载准备工具
1、安装Visual Studio
1.1、下载安装工具
安装好之后执行以下步骤
1.2、下载Visual Studio 2022
其他版本可以查看
发布历史记录 | Microsoft Learn
可以根据需要下载对应版本。以2022版为例,如下图所示
2、安装net.core
net core可以在编辑完成代码,发布的时候再下载安装
浏览要下载的所有 .NET 版本| .NET 可以选择下载需要的可用版本(用谷歌浏览器,edg浏览器可能打不开这个地址)
3、安装postman
官网下载安装就好Postman: The World's Leading API Platform | Sign Up for Free
一直划到最后,有一个Download Postman,下载安装就行。可以不用注册账号使用的,有提示,
二、编写C#测试程序
打开visual studio 2022
1、创建新项目
选择C#,Windows,Web API 。选第一个,然后下一步
最后就创建成功了
2、get方法
打开controller,会有一个默认的Get方法
直接运行会得到一个网页API文档,可以用Postman调用文档上的接口得到返回信息
点击try it out
再点击execute
得到测试返回数据
3、postman测试get请求
最后可以尝试用postman调用这个地址
一句请求参数
curl -X 'GET' \ 'https://localhost:7194/WeatherForecast' \ -H 'accept: text/plain'GET请求,地址是https://localhost:7194/WeatherForecast,请求参数accept: text/plain
postman默认请求参数accept是all,所以参数保持默认就好
可以看到有返回结果
4、post方法
4.1创建一个类
创建一个返回数据结构的类,在实际项目中会有很多类用来管理数据结构
在Controllers文件夹平级创建一个存放类的文件夹,
文件夹右键,添加类
4.2编写post方法逻辑
在controller里面增加一个post方法
保存,右键项目名称,点生成
可以像get请求一样测试这个post请求,
这里得输入输出都是根据自己的想法编的,主要是为了测试接口的数据流通
到这里,我们的建议练习接口就已经完成了
最后是发布到本地和服务器上
三、发布测试
1、本地发布
右键项目--》发布
1.1本地配置IIS
(internet Information Services)
首先复制一下目标位置
打开IIS
1.2本地添加应用程序池
应用程序池右键,添加应用程序池
1.3本地添加网站
网站右键,添加网站。名称自行命名,物理地址就是前面发布的时候复制的地址,端口设置一个大一点的
1.4测试本地配置是否成功
在visual studio中运行程序,然后在IIS中点击浏览,在端口号后加上后缀/WeatherForecast,
http://localhost:8090/WeatherForecast
如果能打开的话说明配置是好的
2、服务器发布
CMD运行MSTSC,登录服务器
2.1安装net core
将前面下载的net core 文件复制到服务器上,然后安装
2.2上传项目文件
把发布的时候目标位置的文件路径里面的publish文件内容都打包,然后复制到服务器的D盘上,然后解压
2.3和本地配置一样配置
ISS、应用程序池、网站
如果服务器直接搜索IIS是搜不到internet Information Services
可以使用WIN+R输入inetmgr按回车打开,然后和本地配置一样就好了,
物理路径填写刚刚解压publish的路径就好
2.4服务器web api测试
最后测试用postman在本地调用服务器上的web api