yangxu.pro

摘要： 无论哪种类型的Web API, 都可能需要给其他开发者使用. 所以API的开发者体验是很重要的. API的开发者体验, 简写为 API DX (Developer Experience). 它包含很多东西, 例如如何使用API, 文档, 技术支持等等, 但是最重要的还是API的设计. 如果 API 阅读全文

摘要： 说到验证，那就需要做三件事： 定义验证规则 按验证规则进行检查 报告验证的错误。在把错误报告给API消费者的时候，报告里并不包含到底是服务端还是API消费者引起的错误，这是状态码的工作。而通常响应的Body里面会包含一组验证错误信息，API消费者可以把这些信息展示给API消费者的用户。 定义验证规则 阅读全文

摘要： 什么样的HTTP方法是安全的？ 什么样的HTTP方法是安全的？ 如果一个方法不会改变资源的表述，那么这个方法就被认为是安全的。 如果一个方法不会改变资源的表述，那么这个方法就被认为是安全的。 例如 HTTP GET 和 HTTP HEAD 就被认为是安全的，但需要注意的是，这并不意味着执行GET请求 阅读全文

摘要： 向Web API传递参数 数据可以通过多种方式来传给API。 数据可以通过多种方式来传给API。 Binding Source Attributes 会告诉 Model 的绑定引擎从哪里找到绑定源。 Binding Source Attributes 会告诉 Model 的绑定引擎从哪里找到绑定源。 阅读全文

摘要： Entity Framework Core 使用的 Entity Model 是用来表示数据库里面的记录的。 Entity Framework Core 使用的 Entity Model 是用来表示数据库里面的记录的。 而面向外部的 model 则表示了要传输的东西。这类 model 有时候叫做 D 阅读全文

摘要： 现在，当谈论起 RESTful Web API 的时候，人们总会想到 JSON。但是实际上，JSON 和 RESTful API 没有半毛钱关系，只不过 JSON 恰好是RESTful API 结果的表述格式。也就是说 RESTful API 还可以使用其它的表述格式，例如 xml 或私有的格式。这 阅读全文

摘要： HTTP状态码 HTTP状态码会告诉API的消费者以下事情： 请求是否执行成功了 如果请求失败了，那么谁为它负责 HTTP的状态码有很多，但是Web API不一定需要支持所有的状态码。HTTP状态码一共分为5个级别： 1xx，属于信息性的状态码。Web API并不使用1xx的状态码。 2xx，意味着 阅读全文

摘要： ASP.NET Core 3.x 的路由 路由机制会把一个请求的URI映射到一个Controller上面的Action，所以当你发送一个HTTP请求的时候，MVC框架会解析这个请求的URI，并尝试着把它映射到一个Controller上面的Action。 ASP.NET Core 3.x 的路由 路由 阅读全文

摘要： 之前讲了RESTful API的统一资源接口这个约束，里面提到了资源是通过URI来进行识别的，每个资源都有自己的URI。URI里还涉及到资源的名称，而针对资源的名称却没有一个标准来进行规范，但是业界还是有一些最佳实践的。那么我们首先看看这些最佳实践对资源命名是如何建议的。 之前讲了RESTful A 阅读全文

摘要： 1. 使用ASP.NET Core 3.x 构建 RESTful API - 1.准备工作 什么是REST 什么是REST REST一词最早是在2000年，由Roy Fielding在他的博士论文《Architectural Styles and the Design of Network-base 阅读全文