接口
愚农
有空就随便写写,不分难易,从代码到架构,从码农到攻城狮
展开
-
WebApi设计原则(转)
接口设计需要考虑哪些方面 接口的命名。 请求参数。 支持的协议。 TPS、并发数、响应时长。 数据存储。DB选型、缓存选型。 是否需要依赖于第三方。 接口是否拆分。 接口是否需要幂等。 防刷。 接口限流、降级。 负载均衡器支持。 如何部署。 是否需要服务治理。 是...转载 2019-10-30 01:44:16 · 822 阅读 · 0 评论 -
反射与接口的合并
做集成对接的接口比较多样。接口设计者经常是定义一个入口,要求调用者传入ActionName来进行导向。比如ActionName为method1,便调用method1方法,并给出相应的返回信息。我们自然可以写死,去switch方法名,然后写调用方法,但这种方式非常冗余,且后续你得一直维护。这里介绍反射。using System.Reflection;Type t = typeo...原创 2019-08-17 12:12:04 · 158 阅读 · 0 评论 -
C#后端传model调用webapi的封装
采用Post,将要传给接口的数据封装进对应的model,再调用此函数。using System;using System.IO;using System.Net;using System.Text;using System.Runtime.Serialization.Json;//4.0.0.0public static string HttpPost(string Url, ...原创 2019-08-01 16:26:46 · 677 阅读 · 0 评论 -
WebApi中的注释对应的Swagger生成规范
<summary>方法简介<param name="参数变量名">参数描述</param>如果是Get传实体参,swagger会自动生成该实体下的所有变量名,要求开发者输入对应的值进行接口测试。若是Post传实体参,右侧会自动生成一个实例,单击即可测试。所以对于比较复杂的参数尽量建实体model。<returns>返回描述...原创 2018-11-16 10:55:29 · 2674 阅读 · 0 评论 -
WebApi的请求方式规范和坑
推荐一篇英文原文https://exceptionnotfound.net/using-http-methods-correctly-in-asp-net-web-api/这里挑重点意译。1.应用功能的方法总体归结为CRUD,对应的HTTP四种方法如下:还有其他的一些方式这里不阐述,看原文。2.webapi中的每个方法前可以加上[HttpPost],[HttpGet]等进行请求...原创 2018-11-14 16:30:14 · 1730 阅读 · 0 评论 -
WebApi的安全性解决方案
一、前言 WebApi的小白想要了解一些关于WebApi安全性相关的问题,本篇文章是整理一些关于WebApi安全、权限认证的文章。二、内容正文 2.1 不进行验证 客户端调用:http://api.xxx.com/getInfo?Id=value如上,这种方式简单粗暴,在浏览器直接输入"http://api.xxx.com/getInfo?Id=value",即可获取到相关的信...转载 2018-11-12 16:20:42 · 6589 阅读 · 0 评论 -
WebApi中Post请求传参时后端的接收方式
1.单参数[FromBody]+变量方式(不推荐):如public string PostUser([FromBody] string user_id){}由于我们的前端习惯用key/value的方式进行请求,而此法要求key为空,有点不三不四,代码不规范,故此不推荐。总不能都是你写的接口,却要求前端因为参数的个数不同而采用不同的代码请求?2.JObject方式(适用于单参数或多参数情...原创 2018-11-15 13:49:52 · 6911 阅读 · 0 评论 -
WebApi vs Controller
webapi继承ApiController。虽然普通的Controller也可以起到接口的作用。但WebApi框架直接支持了async/await,而异步是需要.net 4.5以上版本支持的。另外Swagger UI也支持WebApi总之,想写专业的接口还是用WebApi自带的框架,可以有很多便利。...原创 2018-11-13 18:27:16 · 2142 阅读 · 0 评论 -
Postman测试post接口
总之具体headers,body的用法注意下就Ok了,否则可能会发生请求过去去没有参数值之类的错误。原创 2018-11-06 18:07:06 · 2350 阅读 · 0 评论 -
RESTful API规范
简介rest是一种软件架构风格,如果你们的接口是rest接口,那么就可被认为你们的的接口是restful的,英文名词和形容词的区别。rest接口是围绕“资源”展开的,利用HTTP的协议,其实rest本也可以和HTTP无关,但是现在大家普遍的使用rest都是依托于HTTP协议。HTTP 的url即资源。RFC 3986定义了通用的URI语法: URI = sch...转载 2018-10-31 16:44:45 · 592 阅读 · 0 评论