搜索[webapi]结果-低调大师优秀个人博客

精选列表

搜索[webapi]，共291篇文章

C# webapi相关问题记录

C# Swagger问题记录： 1、使用nginx代理时无法访问Swagger 修改文件Web.config;在configuration节点下添加节点（暂未明白该配置项的作用） <add key="aspnet:UseHostHeaderForRequestUrl" value="true"/> 2、使用nginx代理后出现 Can't read from server. It may not have the appropriate access-control-origin settings修改文件Web.config;在system.webServer节点下添加节点 <httpProtocol> <customHeaders> <add name="Access-Control-Allow-Origin" value="*"/> <add name="Access-Control-Allow-Headers" value="Content-Type"/> <add name="Access-Control-Allow-Methods" value="POST, GET, PUT, DELETE, OPTIONS"/> </customHeaders> </httpProtocol>

2020-05-16

WebApi管理和性能测试工具WebApiBenchmarks

WebApiBenchmark 说到WebApi管理和测试工具其实已经非常多的了，Postman、Swagger等在管理和维护上都非常出色；在性能测试方面也有不少的工具如:wrk,bombardier,

2019-03-09

【WebAPI No.4】Swagger实现API文档功能

开始使用：首先我们要有一个WebAPI项目，假设我们已经创建好了，不懂WebAPI如何创建的请看这篇文章：创建简单的WebAPI 好了现在我们已经有了项目那我们就开始添加引用吧： Nuget命令行：

2018-06-26

webapi 控制json的字段(key)显示顺序

原文: webapi 控制json的字段(key)显示顺序使用两个c#的特性：加在类上的：[DataContract] 加在字段上的：[DataMember(Name = "ResultCode",

2018-06-06

WebAPi的可视化输出模式(RabbitMQ、消息补偿相关)所有webapi似乎都缺失的一个功能

（后面我会整理一篇专门讲解“rabbitmq高可用、故障转移集群架构“文章，所以这里我们就不继续介绍了）这是一个铺垫，本文的重点是介绍下我在尝试使用可视化webapi的输出模式，这比原本json的输出模式看起来会方便许多

2017-11-15

WebAPi的可视化输出模式(RabbitMQ、消息补偿相关）——所有webapi似乎都缺失的一个功能

2017-10-24

教你 4 步搭建弹性可扩展的 WebAPI

导读：本节课程主要分为三个部分，基本概念中介绍基于函数计算的 WebAPI 与普通的 WebAPI 的区别及优势；开发流程中介绍如何在函数计算的控制台进行 WebAPI 的开发；操作演示中会实例演示函数计算

2020-09-10

.netcore 3.1高性能微服务架构：webapi规范

1.1 定义1、基础接口：单一职责原则，每个接口只负责各自的业务，下接db，通用性强。 2、聚合接口：根据调用方需求聚合基础接口数据，业务性强。 1.2 协议客户端在通过 API 与后端服务通信的过程中，应该使用 HTTPS（生产环境）协议服务端响应的数据格式统一为JSON 1.3域名hostprd环境：https://xxx-xxx-api.example.com/ uat环境：https://xxx-xxx-api-uat.example.com/ test环境：https://xxx-xxx-api-test.example.com/ dev环境：https://xxx-xxx-api-dev.example.com/ 将api放到子域名里，这种做法可以保持某些规模化上的灵活性。 1.4路径pathpath命名应该是以资源为导向的命名，对资源的操作是由HttpMethod（get、post、put、delete）来决定。所以一般来说url上的单词都应该是名词，一定不要是动词。一般遵循以下约定：（1）URL 的命名必须全部小写；（2） URL 必须是易读的 URL；（3）一定不可暴露服务器架构（4）出现复合词汇使用下划线分隔，例如：animal_types 举几个正面例子：新增用户：http://localhost/user post方法提交; 修改用户：http://localhost/users put方法提交; 删除文章：http://localhost/articles?author=1&category=2 delete方法提交; 查询用户：http://localhost/users get方法提交; 查询文章：http://localhost/articles?author=1&category=2get方法提交; 错误的例子如下： http://localhost/get_user https://api.example.com/getUserInfo?userid=1 https://api.example.com/getusers https://api.example.com/sv/u https://api.example.com/cgi-bin/users/get_user.php?userid=1 1.5动词RESTful 的核心思想就是，客户端发出的数据操作指令都是"动词 + 宾语"的结构，动词通常就是四种 HTTP 方法，对应 CRUD 操作： GET（SELECT）：从服务器取出资源（一项或多项）。 POST（CREATE）：在服务器新建一个资源。 PUT（UPDATE）：在服务器更新资源（客户端提供改变后的完整资源）。 PATCH（UPDATE）：在服务器更新资源（客户端提供改变的属性）。 DELETE（DELETE）：从服务器删除资源。其中 (1)删除资源必须用 DELETE 方法 (2)创建新的资源必须使用 POST 方法 (3)更新资源应该使用 PUT 方法 (4)获取资源信息必须使用 GET 方法针对每一个路径来说，下面列出所有可行的 HTTP 动词和端点的组合请求方 URL 描述法 GET /zoos 列出所有的动物园(ID和名称，不要太详细) POST /zoos 新增一个新的动物园 GET /zoos/{zoo} 获取指定动物园详情 PUT /zoos/{zoo} 更新指定动物园(整个对象) PATCH /zoos/{zoo} 更新动物园(部分对象) DELETE /zoos/{zoo} 删除指定动物园 GET /zoos/{zoo}/animals 检索指定动物园下的动物列表(ID和名称，不要太详细) GET /animals 列出所有动物(ID和名称)。 POST /animals 新增新的动物 GET /animals/{animal} 获取指定的动物详情 PUT /animals/{animal} 更新指定的动物(整个对象) PATCH /animals/{animal} 更新指定的动物(部分对象) GET /animal_types 获取所有动物类型(ID和名称，不要太详细) GET /animal_types/{type} 获取指定的动物类型详情 GET /employees 检索整个雇员列表 GET /employees/{employee} 检索指定特定的员工 GET /zoos/{zoo}/employees 检索在这个动物园工作的雇员的名单(身份证和姓名) POST /employees 新增指定新员工 POST /zoos/{zoo}/employees 在特定的动物园雇佣一名员工 DELETE /zoos/{zoo}/employees/{employee} 从某个动物园解雇一名员工 1.6入参 1、如果记录数量很多，服务器不可能都将它们返回给用户。API 应该提供参数，过滤返回结果。下面是一些常见的参数。 ?limit=10：指定返回记录的数量?oﬀset=10：指定返回记录的开始位置。?page=2&per_page=100：指定第几页，以及每页的记录数。?sortby=name&order=asc：指定返回结果按照哪个属性排序，以及排序顺序。?animal_type_id=1：指定筛选条件所有URL参数必须是全小写，必须使用下划线类型的参数形式。分页参数必须固定为 page 、 per_page 经常使用的、复杂的查询应该标签化，降低维护成本，如 GET /trades?status=closed&sort=sortby=name&order=asc 可为其定制快捷方式 GET /trades/recently_closed 2、入参可分为业务参数和公共参数；公共参数有：参数名称说明 timestamp 时间戳 clientid 调用方appid 统一管理应用，否则不放行 token 令牌幂等情况可用 version 版本号 1.7响应1、出参(返回值)：必须的字段有：字段类型描述 code 数值状态码 msg 字符串信息描述 data 结果集返回结果集 2、如果请求处理完全正确，则状态码为0 ； 3、状态码暂定8位数数字，前4位为某一个应用（服务）拟的一个数字，后4位为具体的状态值。状态码分为2种---公共和自定义，公共码以0打头+3位数。比如： 99990400 --客户端错误，比如请求语法格式错误、无效的请求、无效的签名等。 99991001 -----用户Id不能为空响应的公共码如下：编码描述说明 001 注解使用错误 002 微服务不在线，或网络超时 003 TOKEN解析失败 004 TOKEN无效或没有对应的用户 400 客户端错误，比如请求语法格式错误、无效的请求、无效的签名等。服务器应该放弃该请求 401 需要身份认证，比如access_token 无效/过期客户端在收到 401 响应后，都应该提示用户进行下一步的登录操作 403 没有权限访问该请求服务器收到请求但拒绝提供服务。如当普通用户请求操作管理员用户时，必须返回该状态码 404 用户请求的资源不存在如获取不存在的用户信息 410 请求的资源不存在，并且未来也不会存在在收到 410 状态码后，客户端应该停止再次请求该资源。 429 请求次数超过允许范围 500 未知异常应该提供完整的错误信息支持，也方便跟踪调试 1.8项目结构 1、采用经典DDD领域取到模型：（默认一个解决方案有5个项目） 5个项目分别为： Web层为最外层接口定义； Service为具体的应用服务处理； Infrastructure基础设施层，处理具体的业务逻辑和数据DB的处理； Domain领域层为模型和仓库接口interface; Common为通用的一些Helper类； 2、一个解决方案创建5个项目（如上图），并且里包含常用的基础组件：Log4net日志，听云监听；dockerfile,skywalking,全局异常捕捉，接口请求开始和结束的日志记录，swagger，service层的依赖注入，Mapping等。 3、代码全部采用依赖注入写法，尽量少些静态类； 4、HttpClient的写法：使用采用.netcore官方提供的方法，采用工厂类+依赖注入方式：实例代码如下：复制代码1、SartUp类里添加代码-- httpclient初始化： services.AddHttpClient("MsgApi", c => { c.BaseAddress = new Uri(Configuration["OuterApi:MsgApi:url"]); c.Timeout = TimeSpan.FromSeconds(30); }); //2 构造函注入private IDbContext _dbContext;private IUnitOfWork _unitOfWork;private IordersRepository _ordersRepository;private IordercourseRepository _ordercourseRepository;private ILogger _logger;privatereadonly IConfiguration _config;privatereadonly IHttpClientFactory _clientFactory; public ordersService(IDbContext dbContext, ILogger logger, IConfiguration config, IHttpClientFactory clientFactory) { _dbContext = dbContext; _unitOfWork = new UnitOfWork(_dbContext); _ordersRepository = new ordersRepository(_dbContext); _ordercourseRepository = new ordercourseRepository(_dbContext); _mapper = mapper; _config = config; _logger = logger; _clientFactory = clientFactory; } //3使用 //////判断此时该校区是否可以下单/////////publicasync Task> CheckDept(CheckSchoolDeptReq req) { Result<string> sendRet = new Result<string>(); try { HttpClient client = _clientFactory.CreateClient("ContractApi"); MyHttpClientHelper myHttpClientHelper = new MyHttpClientHelper(); MarketToUPCCheckReq checkreq = new MarketToUPCCheckReq(); sendRet = await myHttpClientHelper.GetData<Result<string>>(client, "MarketToUPCCheck", checkreq); } catch (Exception ex) { sendRet.state = false; sendRet.error_code = ErrorCode.SysExceptionError; sendRet.error_msg = "调用《是否可以下订单接口》报错了。请重试或者联系管理员！"; _logger.LogError(ex, ErrorCode.SysExceptionError +"调用《是否可以下订单》接口报错了：" + ex.Message); } return sendRet; } 复制代码 1.9日志 1、接口开始前和结束后都已在LogstashFilter里记录，接口里就不需要再次记录； LogstashFilter里的代码如下：复制代码 /// /// 记录日志用过滤器 /// </summary> public class LogstashFilter : IActionFilter, IResultFilter { private string ActionArguments { get; set; } /// <summary> /// 请求体中的所有值 /// </summary> private string RequestBody { get; set; } private Stopwatch Stopwatch { get; set; } private ILogger _logger; public LogstashFilter(ILogger<LogstashFilter> logger ) { _logger = logger; } /// <summary> /// Action 调用前执行 /// </summary> /// <param name="context"></param> public void OnActionExecuting(ActionExecutingContext context) { long contentLen = context.HttpContext.Request.ContentLength == null ? 0 : context.HttpContext.Request.ContentLength.Value; if (contentLen > 0) { // 读取请求体中所有内容 System.IO.Stream stream = context.HttpContext.Request.Body; if (context.HttpContext.Request.Method == "POST") { stream.Position = 0; } byte[] buffer = new byte[contentLen]; stream.Read(buffer, 0, buffer.Length); RequestBody = System.Text.Encoding.UTF8.GetString(buffer);// 转化为字符串 } ActionArguments = JsonConvert.SerializeObject(context.ActionArguments); Stopwatch = new Stopwatch(); Stopwatch.Start(); string url = context.HttpContext.Request.Host + context.HttpContext.Request.Path + context.HttpContext.Request.QueryString; string method = context.HttpContext.Request.Method; _logger.LogInformation($"地址：{url} \n " + $"方式：{method} \n " + $"请求体：{RequestBody} \n " + $"完整参数：{ActionArguments}\n " ); } /// <summary> /// Action 方法调用后，Result 方法调用前执行 /// </summary> /// <param name="context"></param> public void OnActionExecuted(ActionExecutedContext context) { // do nothing } /// <summary> /// Result 方法调用前（View 呈现前）执行 /// </summary> /// <param name="context"></param> public void OnResultExecuting(ResultExecutingContext context) { // do nothing } /// <summary> /// Result 方法调用后执行 /// </summary> /// <param name="context"></param> public void OnResultExecuted(ResultExecutedContext context) { Stopwatch.Stop(); string url = context.HttpContext.Request.Host + context.HttpContext.Request.Path + context.HttpContext.Request.QueryString; string method = context.HttpContext.Request.Method; string qs = ActionArguments; string res = "在返回结果前发生了异常"; if (context.Result is ObjectResult) { dynamic result = context.Result.GetType().Name == "EmptyResult" ? new { Value = "无返回结果" } : context.Result as dynamic; if (result != null) { res = JsonConvert.SerializeObject(result.Value); } } _logger.LogInformation($"地址：{url} \n " + $"方式：{method} \n " + $"请求体：{RequestBody} \n " + $"参数：{qs}\n " + $"结果：{res}\n " + $"耗时：{Stopwatch.Elapsed.TotalMilliseconds} 毫秒"); } } 复制代码 2、try Catch日志必须要添加LogError日志，并且要将堆栈信息记录，代码如下： catch (Exception ex) { _logger.LogError(ex, ErrorCode500 + ex.Message); }

2020-02-19

3.C#WebAPI设置路由和参数2

如果用string AddNew(string phoneNum, string password)这种普通参数会有很多的坑（参考《C#进阶系列—— WebApi 接口参数不再困惑：传参详解》），所以不要用

2018-06-20

C# WebApi+Task+WebSocket实战项目演练(四)

本高级系列课程适合人群如下： 1、有一定的NET开发基础并对WebApi、Task、WebSocket技术有一定了解和认识。 2、喜欢阿笨的干货分享课程的童鞋们。

2018-03-09

如何将 .NetFramework WebApi 按业务拆分成多个模块

如何将 .NetFramework WebApi 按业务拆分成多个模块在.NetFramework中使用WebApi，在不讨论微服务的模式下，大部分都是以层来拆分库的 : 基础设施数据存储层服务层WeApi

2020-04-10

ASP.NET Core微服务之Docker容器化WebAPI

那么删除一个吧，如：# docker rmi imagesID 拉取之后，验证一下是否拉取成功了：# docker images （2）现在我们进入VS中为我们的一个ASP.NET Core WebAPI

2019-06-19

Retrofit2.0+ .Net MVC4(WebApi) 上传多张图片

最近在做Android项目，使用的是MVP+Retrofit+rxjava+dagger的项目架构，RestFul 服务使用的.Net平台的WebApi。由于业务中需要有多文件上传的功能。

2017-11-06

XXL-HEX v1.2.0，面向对象的 WebAPI 框架

webapp/jsclient.html"，启动 "xxl-hex-example" 项目访问即可）； 2、Server端，新增明文模式：如果系统不需要Hex加密特性，可选择明文数据传输方案；《面向对象的WebAPI

2017-06-01

吃透 Dapper 异步操作，WebAPI 性能直接翻倍

同步 Dapper 写起来很顺手，但一上 Web API 就得换异步。这篇聊为什么以及怎么用。

2026-07-21

dotnet core webapi +vue 搭建前后端完全分离web架构(一)

架构服务端采用 dotnet core webapi 前端采用: Vue + router +elementUI+axios 问题使用前后端完全分离的架构，首先遇到的问题肯定是跨域访问。

2018-07-15

🔥 把 Java WebApi 快速转为 Mcp-Server（使用 Solon AI MCP）

solon-ai-mcp，提供了各种 mcp 相关能力，支持 java8, java11, java17, java21, java24 。是 solon-ai 项目的重要组成部分，也可以嵌入到 springboot2, springboot3, jfinal, vert.x 等项目中使用。依赖包： <dependency> <groupId>org.noear</groupId> <artifactId>solon-ai-mcp</artifactId> <version>最新版</version> </dependency> 1、看一个简单的 web 控制器此控制器有两个方法：get_weather，获取天气；get_rainfall，获取降雨量。后面基于它进行快速改造演示。 @Mapping("/web/api") @Controller public class McpServerTool { @Mapping("get_weather") public String get_weather(String location) { return "晴，14度"; } @Mapping("get_rainfall") public String get_rainfall(String location) { return "555毫米"; } } 2、改造方案1：复用 mvc 注解，并添加@McpServerEndpoint注解在 mvc 注解基础上，给方法和参数添加描述信息description信息（只适合 solon-web 项目，它的注解带有description属性）。再添加@McpServerEndpoint注解 @McpServerEndpoint(sseEndpoint = "/mcp/sse") @Mapping("/web/api") @Controller public class McpServerTool { @Mapping(path="get_weather", description = "查询天气预报") public String get_weather(@Param(description = "城市位置") String location) { return "晴，14度"; } @Mapping(path="get_rainfall", description = "查询城市降雨量") public String get_rainfall(@Param(description = "城市位置") String location) { return "555毫米"; } } 这个方案的提醒说明： @Mapping（通用注解）相当于 ai 的@ToolMapping（专用注解） @Param（通用注解）相当于 ai 的@ToolParam（专用注解）必须申明description属性（否则会异常提示） 3、改造方案2：在控制器上，添加完整的 Mcp 相关注解这个方案也适合 springboot2-web、sprngboot3-web、spring-mvc 或 jfinal 等项目，原控制器的代码不用动（原来有没有注解，不影响）。就像添加 swagger 注解那样，添加 mcp 相关注解即可。注解简单说明（?表示可选属性）：注解描述 @ToolMapping(name?, description, returnDirect?, resultConverter?) 工具映射 @ToolParam(name?, description, required?) 工具的参数申明改造后的代码： @McpServerEndpoint(sseEndpoint = "/mcp/sse") @Mapping("/web/api") @RestController public class McpServerTool { @ToolMapping(description = "查询天气预报") @GetMapping("get_weather") public String get_weather(@ToolParam(description = "城市位置") String location) { return "晴，14度"; } @ToolMapping(description = "查询城市降雨量") @GetMapping("get_rainfall") public String get_rainfall(@ToolParam(description = "城市位置") String location) { return "555毫米"; } } 4、也可以转为本地的大模型工具提供者使用（ToolProvider）上两个方案去掉@McpServerEndpoint注解，就不会发布为 MCP 服务端点。使用 MethodToolProvider 加载它，就能成为本地的工具提供者。 MethodToolProvider toolProvider = new MethodToolProvider(new McpServerTool()); var chatModel = ChatModel.of(...) .defaultToolsAdd(toolProvider) //添加默认工具 .build(); chatModel.prompt("杭州今天的天气怎么样？") .call(); 5、附代码仓库 solon-ai（源码） https://gitee.com/opensolon/solon-ai https://gitcode.com/opensolon/solon-ai https://github.com/opensolon/solon-ai solon-ai-mcp-embedded-examples（嵌入示例） https://gitee.com/opensolon/solon-ai-mcp-embedded-examples https://gitcode.com/opensolon/solon-ai-mcp-embedded-examples https://github.com/opensolon/solon-ai-mcp-embedded-examples

2025-04-27

使用 C# + WPF + WebApi 构建前后端分离的桌面应用——从零到部署

WPF 作为成熟的 UI 框架，搭配 ASP.NET Core WebApi 作为服务端，既能发挥桌面端丰富的交互能力，又能利用 WebApi 实现业务逻辑统一、多客户端复用。

2026-07-29

Docker 为 ASP.NET Core WebApi 应用程序生成 Docker 映像，创建容器并运行

1.使用VS2017新建ASP.NET Core WebApi项目选择API启用Docker支持 2.为 ASP.NET Core WebApi 应用程序生成 Docker 映像，并创建容器运行生成项目

2019-10-19

ASP.NET Core WebApi使用Swagger生成api说明文档看这篇就够了

Try it out ” 按钮在出现的参数文本框中输入参数，如下图所示的，输入参数2 点击执行按钮，会出现下面所示的格式化后的Response，如下图所示好了，今天的在ASP.NET Core WebApi

2018-06-27

资源下载

更多资源

Mario

马里奥是站在游戏界顶峰的超人气多面角色。马里奥靠吃蘑菇成长，特征是大鼻子、头戴帽子、身穿背带裤，还留着胡子。与他的双胞胎兄弟路易基一起，长年担任任天堂的招牌角色。

Nacos

Nacos /nɑ:kəʊs/ 是 Dynamic Naming and Configuration Service 的首字母简称，一个易于构建 AI Agent 应用的动态服务发现、配置管理和AI智能体管理平台。Nacos 致力于帮助您发现、配置和管理微服务及AI智能体应用。Nacos 提供了一组简单易用的特性集，帮助您快速实现动态服务发现、服务配置、服务元数据、流量管理。Nacos 帮助您更敏捷和容易地构建、交付和管理微服务平台。

Spring

Spring框架（Spring Framework）是由Rod Johnson于2002年提出的开源Java企业级应用框架，旨在通过使用JavaBean替代传统EJB实现方式降低企业级编程开发的复杂性。该框架基于简单性、可测试性和松耦合性设计理念，提供核心容器、应用上下文、数据访问集成等模块，支持整合Hibernate、Struts等第三方框架，其适用范围不仅限于服务器端开发，绝大多数Java应用均可从中受益。

Sublime Text

Sublime Text具有漂亮的用户界面和强大的功能，例如代码缩略图，Python的插件，代码段等。还可自定义键绑定，菜单和工具栏。Sublime Text 的主要功能包括：拼写检查，书签，完整的 Python API ， Goto 功能，即时项目切换，多选择，多窗口等等。Sublime Text 是一个跨平台的编辑器，同时支持Windows、Linux、Mac OS X等操作系统。