首页
学习
活动
专区
工具
TVP
发布
精选内容/技术社群/优惠产品,尽在小程序
立即前往

Microsoft REST API指南

有关选项使用的示例,请参见完善CORS跨域调用。 7.5 标准的请求标头 下面的请求标头表 应该遵循 Microsoft REST API指南服务使用。...因此,服务应该接受PII参数作为标头传输。 然而在实践中,由于客户端或软件的限制,在许多情况下无法遵循上述建议。...对于任何其他标头或值,将发生预检请求。 8.2....其他任何内容类型都会引发预检请求。 服务不得以避免CORS预检请求的名义违反其他API指南。由于内容类型的原因,大多数POST请求实际上需要预检请求。...Pagination 返回集合的RESTful API可能返回部分集。 这些服务的消费者清楚将获得部分结果集,并能正确地翻页以检索整个结果集。 RESTful API可能支持两种形式的分页。

4.6K11

跟我一起探索 HTTP-HTTP缓存

例如,HTTP 缓存规范本质上没有定义显式删除缓存的方法——但是使用托管缓存,可以通过仪表板操作、API 调用、重新启动等实时删除已经存储的响应。这允许更主动的缓存策略。...If-None-Match 值相同,则服务器将返回 304 Not Modified。...在这种情况下,使用 private 指令将导致个性化响应仅与特定客户端一起存储,而不会泄露给缓存的任何其他用户。...doctype html> … 一旦响应在服务器上过期,你可能希望覆盖该响应,但是一旦存储响应,服务器就无法执行任何操作——因为由于缓存,不再有请求到达服务器。...请求折叠 共享缓存主要位于源服务器之前,旨在减少到源服务器的流量。 因此,如果多个相同的请求同时到达共享缓存,中间缓存将代表自己将单个请求转发到源,然后源可以将结果重用于所有客户端。这称为请求折叠。

28151
  • 您找到你想要的搜索结果了吗?
    是的
    没有找到

    跨域资源共享(CORS)

    由于该请求使用的Content-Type为application/xml,并且由于设置了自定义标头,因此该请求被预检。...但是,如果请求是由于请求中存在Authorization标头而触发预检的请求,则无法使用上述步骤解决限制。除非您可以控制请求的服务器,否则您将根本无法解决它。...默认情况下,调用是在不使用Cookie的情况下进行的。由于这是一个简单的GET请求,因此不会进行预检,但是浏览器将拒绝任何没有标题的响应,并且不会使响应可用于调用Web内容。...但这不会失败:因为Access-Control-Allow-Origin标头的值是“ http://foo.example”(实际来源)而不是“ *”通配符,所以凭据识别内容将返回到正在调用的Web内容...请注意,简单的GET请求不会被预先处理,因此,如果对具有凭据的资源进行请求,则如果此标头未随资源一起返回,则浏览器将忽略该响应,并且该响应不会返回到Web内容。

    3.6K50

    从0开始构建一个Oauth2Server服务 发起认证请求

    虽然先发制人地刷新访问令牌可以节省 HTTP 请求,但您仍然需要处理 API 调用在您预期令牌过期之前报告过期令牌的情况,因为访问令牌可能因许多超出预期寿命的原因而过期。...有些人喜欢在当前访问令牌到期前不久获得一个新的访问令牌,以保存 API 调用失败的 HTTP 请求。...在任何情况下,WWW-Authenticate标头也会有invalid_token错误代码。...刷新令牌的到期时间有意从不传达给客户端。这是因为即使客户端能够知道刷新令牌何时过期,也无法采取任何可操作的步骤。刷新令牌也可能在其任何预期生命周期之前过期的原因有很多。...这就是应用程序是否知道刷新令牌的预期寿命无关紧要的原因,因为无论它过期的原因如何,结果总是相同的。

    19330

    ASP.NET Web API编程——控制器

    2控制器操作返回值 类型 说明 void 操作返回值为void时,Web API返回空HTTP响应,其状态码为204(无内容) HttpResponseMessage Web api会将此返回值直接转换为...第一种调用HttpResponseMessage的构造函数,实例化一个HttpResponseMessage,并返回。Web API会将其直接转换为HTTP消息。...//返回 System.String。 服务器发送的原因词组。...当控制器操作返回此类型时,Web API会调用ExecuteAsync方法创建类型为HttpResponseMessage的实例,然后将这个实例转换为HTTP消息。...PUT与POST方法的区别在于,PUT方法是幂等的:调用一次与连续调用多次是等价的(即没有副作用),而连续调用多次POST方法可能会有副作用,比如将一个订单重复提交多次。

    2.3K50

    【API架构】REST API 设计的原则和最佳实践

    基于资源:在请求中使用 URI 作为资源标识符来标识单个资源。资源本身在概念上与返回给客户端的表示分开。...超媒体作为应用程序状态引擎 (HATEOAS):客户端通过正文内容、查询字符串参数、请求标头和请求的 URI(资源名称)传递状态。服务通过正文内容、响应代码和响应头向客户端提供状态。...由于维护多个版本变得繁琐、复杂、容易出错且成本高昂,因此对于任何给定资源,您应该支持不超过两个版本。 缓存:缓存通过启用系统中的层来消除检索请求数据的远程调用来增强可扩展性。...原因是“客户”是服务套件中的一个集合,而 ID(例如 33245)指的是集合中的这些客户之一。 监控:确保添加各种监控以提高 API 的质量或性能。...- 幂等性:如果执行一次或多次,将产生相同结果的操作。根据其适用的上下文,它可能具有不同的含义。例如,在具有副作用的方法或子程序调用的情况下,这意味着修改后的状态在第一次调用后保持不变。

    1.4K10

    知识分享之规范——HTTP 状态码

    服务器可以返回更新后的元信息。 205 重置内容 指示客户端重置发送此请求的文档。 206部分内容 当Range从客户端发送标头以仅请求资源的一部分时使用它。...(RFC 2324) 420增强你的冷静(推特) 当客户端受到速率限制时,由 Twitter 搜索和趋势 API 返回。...422 无法处理的实体 (WebDAV) 服务器理解请求实体的内容类型和语法,但由于某种原因仍然无法处理请求。 423 锁定 (WebDAV) 正在访问的资源被锁定。...431 请求标头字段太大 服务器不愿意处理请求,因为它的头字段太大。 444无响应(Nginx) Nginx 服务器不向客户端返回任何信息并关闭连接。...451 因法律原因不可用 用户代理请求的资源无法合法提供。 499 客户端关闭请求(Nginx) 当 HTTP 服务器正在处理其请求时,客户端关闭了连接,使服务器无法发回 HTTP 标头。

    1.9K30

    REST API设计指导——译自Microsoft REST API Guidelines(四)

    这有助于用户发现并简化接口的调用,即使平台没有良好的客户端SDK支持。 PS:为啥微信SDK那么多,API不友好是很大的一个原因。...表的请求头应该遵循微软REST API服务规范。使用这些标头不是必须的,但是如果用到,那么它们必须使用一致。...如果客户端通过指定返回内容有实际意义或价值,或者有时响应内容过多会对带宽造成太大的影响,那么服务就应该支持这个头部。 PS:通过将Prefer标头设置可以省略响应正文。...基本的API操作禁止定义自定义标头。...在HTTP中,客户端应该使用Accept标头请求响应格式。 服务端可以选择性的忽略,即使这不是典型的良好的服务。 客户端可以发送多个Accept标头,服务可以选择其中一个格式进行返回。

    2K50

    Nginx code 状态码说明

    一个普通的http请求处理流程,如上图所示: A -> client端发起请求给nginx B -> nginx处理后,将请求转发到uwsgi,并等待结果 C -> uwsgi处理完请求后,返回数据给nginx...D -> nginx将处理结果返回给客户端 每个阶段都会有一个预设的超时时间,由于网络、机器负载、代码异常等等各种原因,如果某个阶段没有在预期的时间内正常返回,就会导致这次请求异常,进而产生不同的状态码...A+B+C+D > 500ms 其实这个时候,server端有可能还在处理请求,只不过client断掉了连接,因此处理结果也无法返回给客户端。 499如果比较多的话,可能会引起服务雪崩。...服务器必须在响应中包含有关冲突的信息。 410 (已删除) 如果请求的资源已永久删除,服务器就会返回此响应。 411 (需要有效长度) 服务器不接受不含有效内容长度标头字段的请求。...416 (请求范围不符合要求) 如果页面无法提供请求的范围,则服务器会返回此状态代码。 417 (未满足期望值) 服务器未满足"期望"请求标头字段的要求。

    4.6K30

    Android O 行为变更官方指南

    之前,这些请求没有 Content-Length 标头。 HttpURLConnection 在包含斜线的主机或颁发机构名称后面附加一条斜线,使包含空路径的网址规范化。...相反,由系统生成 proxy-authorization 标头,在代理响应初始请求发送 HTTP 407 后将其发送至此代理。...同样地,系统不再将 user-agent 标头由隧道连接请求复制到建立隧道的代理请求。相反,库为此请求生成 user-agent 标头。...对于确实无法访问的主机,此项变更意味着调用需要两倍的时间才能返回结果。...平台不会拦截 Java 对 loadClass ( ) 函数的直接调用,也不会检查此类调用的结果。此行为不应影响运行良好的类加载器的正常运行。 平台将检查类加载器返回的类描述符是否与预期的描述符一致。

    1.7K20

    Monzo 采用有针对性的流量削峰策略,以抵御移动应用引发的惊群效应

    为了消除“浪费”的请求,工程师首先选择创建一个“更改 API”,该 API 将返回最常用和昂贵的终端的最后更新时间。移动应用程序将查询新的更改 API,并仅在自上次调用以来数据已更改时才请求数据。...对于第一个特征,工程师重新利用了 API 终端返回的 Etag HTTP 标头,其中包含响应哈希和上次计算的时间。...在预取数据时,移动应用程序将发送包含与相同请求的先前返回的 Etag 标头的值以及自定义标头中的其他两个特征的 If-None-Match HTTP 标头。...基于标头中的元数据,边缘代理中部署的负载削减策略将确定是否忽略请求并返回 304(未修改)状态码或返回计算的响应。不同的预取触发器的策略可以分别激活,使团队逐步减少移动应用程序流量的各个部分。...启用请求削峰后的流量减少。(来源:Monzo Technology Blog) 团队通过在阴影模式下部署新的策略进行试验,即计算响应并根据请求元数据与实际结果进行比较来决定是否削减请求。

    15410

    对不起,看完这篇HTTP,真的可以吊打面试官

    即使客户端和服务器都能够支持相同的压缩算法,服务器也可能选择不压缩并返回,这种情况可能是由于这两种情况造成的: 要发送的数据已经被压缩了一次,第二次压缩并不会导致发送的数据更小 服务器过载,无法承受压缩带来的性能开销...下面我们依次介绍一下这些属性 不缓存 no-store 才是真正意义上的不缓存,每次服务器接受到客户端的请求后,都会返回最新的资源给客户端。...由于这是一个简单的 GET 请求,因此不会进行预检,但是浏览器将拒绝任何没有 Access-Control-Allow-Credentials 的响应:标头为true,指的是响应不会返回 web 页面的内容...注意上面示例中的 Set-Cookie 响应标头还设置了另外一个值,如果发生故障,将引发异常(取决于所使用的API)。...原则 HTTP 条件请求是根据特定标头的值执行不同的请求,这些标头定义了一个前提条件,如果前提条件匹配或不匹配,则请求的结果将有所不同。

    6.4K21

    Nginx code 状态码说明

    一个http请求处理流程: 一个普通的http请求处理流程,如上图所示: A -> client端发起请求给nginx B -> nginx处理后,将请求转发到uwsgi,并等待结果 C -> uwsgi...处理完请求后,返回数据给nginx D -> nginx将处理结果返回给客户端 每个阶段都会有一个预设的超时时间,由于网络、机器负载、代码异常等等各种原因,如果某个阶段没有在预期的时间内正常返回,就会导致这次请求异常...A+B+C+D > 500ms 其实这个时候,server端有可能还在处理请求,只不过client断掉了连接,因此处理结果也无法返回给客户端。 499如果比较多的话,可能会引起服务雪崩。...服务器必须在响应中包含有关冲突的信息。 410 (已删除) 如果请求的资源已永久删除,服务器就会返回此响应。 411 (需要有效长度) 服务器不接受不含有效内容长度标头字段的请求。...416 (请求范围不符合要求) 如果页面无法提供请求的范围,则服务器会返回此状态代码。 417 (未满足期望值) 服务器未满足"期望"请求标头字段的要求。

    4.6K80

    Jquery Ajax请求文件下载操作失败的原因分析及解决办法

    文件的下载是以二进制形式进行的,虽然可以读取到返回的response,但只是读取而已,是无法执行的,说白点就是js无法调用到浏览器的下载处理机制和程序。...在任何回调函数被调用之前,响应被作为一个或多个JavaScript语句而进行处理 text-响应文本被假定为普通文本。服务器资源负责设置适当的内容类型响应标头。...响应体作为第一个参数被返回给这个函数,并且根据指定的dataType属性进行。...这个函数被传递XHR实例,并且可以用来设置自定义的标头或执行其他预请求操作 async 布尔型 如果指定为false,则请求被提交为同步请求。...(根据Last-Modified标头)才允许请求成功。

    3.6K30

    跟我一起探索 HTTP-跨源资源共享(CORS)

    -255) 备注: Firefox 还没有将 Range 实现为安全的请求标头。...不过,如果请求是由于存在 Authorization 字段而引发了预检请求,则这一方法将无法使用。这种情况只能由服务端进行更改。...但是,如果服务器端的响应中未携带 Access-Control-Allow-Credentials: true,浏览器将不会把响应内容返回给请求的发送者。...HTTP 响应标头字段 本节列出了服务器为访问控制请求返回的 HTTP 响应头,这是由跨源资源共享规范定义的。上一小节中,我们已经看到了这些标头字段在实际场景中是如何工作的。...请注意:简单 GET 请求不会被预检;如果对此类请求的响应中不包含该字段,这个响应将被忽略掉,并且浏览器也不会将相应内容返回给网页。

    38930

    HTTP1.1协议状态码

    再返回给客户端, 在响应状态行中就会用 203 状态码注释, 此信息非权威信息, 非原信息. ---- 204 No Content (无内容) 服务器已满足请求,但不需要返回实体,可能要返回更新的元信息...请求的结果(请参阅第13.3.3节),则该响应不应包含其他实体标头。...如果响应是使用弱验证器的If-Range请求的结果,则响应必须不包括其他实体头;这样可以避免缓存的实体与更新的标头之间的不一致。否则,响应必须包括所有对同一请求返回200(确定)响应的实体头。...---- 400 Bad Request (错误的请求) 由于语法格式错误,服务器无法理解该请求。客户不应在没有修改的情况下重复请求。...此响应代码允许客户端在当前资源元信息(标头字段数据)上放置先决条件,从而防止将请求的方法应用于除预定资源以外的其他资源。

    2.7K40

    REST API有关幂等性等11条最佳实践

    早在 2000 年代,可能会有一些关于客户是否需要 JSON 还是 XML 的问题,但在 2020 年代这个问题已经得到解决。返回 JSON,如果客户端想要协商其他内容,请依赖标准 HTTP 标头。...当调用(例如)GET /things/{thing_id}请求一个不存在的东西时,响应应表明:1)服务器理解了您的请求;2)没有找到该东西。遗憾的是,404 响应并不能保证 #1。...有很多层软件会对请求返回 404,其中有些可能是你无法控制的: 配置错误的客户端点击了错误的 URL 配置错误的代理(客户端和服务器端) 负载平衡器配置错误 服务器应用程序中的路由表配置错误 返回...1、“幂等性键”或“客户端参考 ID” 让客户端通过 POST 提交唯一值,并在服务器上强制该值的唯一性。Stripe使用标头以这种方式工作。...在 409 响应正文中提供原始 ID 亮点:通过允许具有相同参数的重复请求或在冲突时返回现有 ID,使 API 具有幂等性。

    26720

    震惊 | HTTP 在疫情期间把我吓得不敢出门了

    即使客户端和服务器都能够支持相同的压缩算法,服务器也可能选择不压缩并返回,这种情况可能是由于这两种情况造成的: 要发送的数据已经被压缩了一次,第二次压缩并不会导致发送的数据更小 服务器过载,无法承受压缩带来的性能开销...下面我们依次介绍一下这些属性 不缓存 no-store 才是真正意义上的不缓存,每次服务器接受到客户端的请求后,都会返回最新的资源给客户端。...由于这是一个简单的 GET 请求,因此不会进行预检,但是浏览器将拒绝任何没有 Access-Control-Allow-Credentials 的响应:标头为true,指的是响应不会返回 web 页面的内容...注意上面示例中的 Set-Cookie 响应标头还设置了另外一个值,如果发生故障,将引发异常(取决于所使用的API)。...原则 HTTP 条件请求是根据特定标头的值执行不同的请求,这些标头定义了一个前提条件,如果前提条件匹配或不匹配,则请求的结果将有所不同。

    5.4K20

    跨域最佳实践

    本文将深入探讨如何解决无法跨域问题,并介绍一些常见的解决方案和最佳实践。 什么是跨域问题? 在深入解决跨域问题之前,首先让我们理解一下什么是跨域问题。...通过在页面中创建一个标签,可以向不同域名的服务器请求数据。服务器将数据包装在一个函数调用中,并将其作为JavaScript代码返回给页面。页面接收到响应后,即可调用该函数来处理数据。...这些标头指定了哪些域名、HTTP方法和自定义标头是允许的。...代理服务器 代理服务器是一种通过将跨域请求转发到同一域的服务器来解决跨域问题的方法。开发者可以在同一域上设置一个代理服务器,该服务器负责与不同域的服务器通信,并将响应返回给页面。...const response = await axios.get('https://api.example.com/data'); // 将响应返回给客户端

    35150

    掌握并理解 CORS (跨域资源共享)

    原因可以在控制台找到: 啊哈!咱们缺少Access-Control-Allow-Origin标头。 但是,为什么我们需要它,它有什么用呢? 同源策略 我们在 JS 中得不到响应结果的原因是同源策略。...注意,尽管同源策略已经生效,但是的咱们的示例请求从thirdparty.com成功请求到good.com,只是我们无法获得结果。但对于CSRF来说,不需要获取的结果。...例如,有个 API 通过POST请求方式发送邮件,返回的内容是咱们需要关心的,蛤攻击者不在乎结果,他们关心的是电子邮件是否有发送了成功。...', '*') res.send(...) }) 这里将access-control-allow-origin标头设置为*,这意味着:允许任何主机访问此URL和获取响应的结果: 非简单的请求和预检...只有得到肯定答复,浏览器才会发出正式的XMLHttpRequest请求,否则就报错。 前面的例子是一个的简单请求。简单的请求是带有一些允许的标头和标志头值的GET或POST请求。

    2.2K10
    领券