<?xml version="1.0" encoding="utf-8" standalone="yes"?><rss version="2.0" xmlns:atom="http://www.w3.org/2005/Atom"><channel><title>API规范 on ZiYang FrontEnd Interview</title><link>https://fe-interview.pangcy.cn/tags/api%E8%A7%84%E8%8C%83/</link><description>Recent content in API规范 on ZiYang FrontEnd Interview</description><generator>Hugo</generator><language>en-us</language><lastBuildDate>Thu, 06 Mar 2025 13:07:39 +0800</lastBuildDate><atom:link href="https://fe-interview.pangcy.cn/tags/api%E8%A7%84%E8%8C%83/index.xml" rel="self" type="application/rss+xml"/><item><title>HTTP请求方法语义规范</title><link>https://fe-interview.pangcy.cn/docs/network/network-10/</link><pubDate>Tue, 04 Mar 2025 09:31:00 +0000</pubDate><guid>https://fe-interview.pangcy.cn/docs/network/network-10/</guid><description>&lt;h2 id="考察点分析">考察点分析 &lt;a href="#%e8%80%83%e5%af%9f%e7%82%b9%e5%88%86%e6%9e%90" class="anchor" aria-hidden="true">&lt;i class="material-icons align-middle">link&lt;/i>&lt;/a>&lt;/h2>&lt;p>该题目主要考核以下核心能力维度：&lt;/p>
&lt;ol>
&lt;li>&lt;strong>HTTP协议规范理解&lt;/strong>：准确辨析各请求方法在RFC标准中的定义&lt;/li>
&lt;li>&lt;strong>RESTful设计原则&lt;/strong>：掌握资源操作语义与HTTP方法的对应关系&lt;/li>
&lt;li>&lt;strong>接口安全性设计&lt;/strong>：正确处理幂等性对系统可靠性的影响&lt;/li>
&lt;/ol>
&lt;p>具体技术评估点：&lt;/p>
&lt;ul>
&lt;li>安全方法(Safe Methods)与副作用的关系&lt;/li>
&lt;li>幂等性(Idempotent)在不同业务场景的表现&lt;/li>
&lt;li>PATCH与PUT在部分更新中的规范差异&lt;/li>
&lt;li>并发控制机制的选择（ETag/版本号）&lt;/li>
&lt;/ul>
&lt;hr>
&lt;h2 id="技术解析">技术解析 &lt;a href="#%e6%8a%80%e6%9c%af%e8%a7%a3%e6%9e%90" class="anchor" aria-hidden="true">&lt;i class="material-icons align-middle">link&lt;/i>&lt;/a>&lt;/h2>&lt;h3 id="关键知识点">关键知识点 &lt;a href="#%e5%85%b3%e9%94%ae%e7%9f%a5%e8%af%86%e7%82%b9" class="anchor" aria-hidden="true">&lt;i class="material-icons align-middle">link&lt;/i>&lt;/a>&lt;/h3>&lt;p>HTTP语义规范 &amp;gt; 幂等性判定 &amp;gt; 部分更新设计&lt;/p>
&lt;h4 id="原理剖析">原理剖析 &lt;a href="#%e5%8e%9f%e7%90%86%e5%89%96%e6%9e%90" class="anchor" aria-hidden="true">&lt;i class="material-icons align-middle">link&lt;/i>&lt;/a>&lt;/h4>&lt;ol>
&lt;li>&lt;strong>安全性(Safe)&lt;/strong>：不修改资源的请求方法（GET/HEAD/OPTIONS）。类比查看书籍目录，不会改变书籍内容&lt;/li>
&lt;li>&lt;strong>幂等性(Idempotent)&lt;/strong>：多次相同请求效果等同于单次执行。数学中的幂等运算（如&lt;code>Math.abs(-5)&lt;/code>）&lt;/li>
&lt;li>&lt;strong>PATCH规范&lt;/strong>：RFC 5789定义的部分更新方法，与PUT的整体替换形成对比。类似打补丁与换整件衣服的区别&lt;/li>
&lt;/ol>
&lt;h4 id="常见误区">常见误区 &lt;a href="#%e5%b8%b8%e8%a7%81%e8%af%af%e5%8c%ba" class="anchor" aria-hidden="true">&lt;i class="material-icons align-middle">link&lt;/i>&lt;/a>&lt;/h4>&lt;ul>
&lt;li>误认为幂等性等同于结果一致性（实际上关注的是资源状态变化）&lt;/li>
&lt;li>混淆PUT与PATCH的应用场景（整体替换 vs 部分更新）&lt;/li>
&lt;li>忽略PATCH的非强制幂等性要求（需自行保证操作幂等）&lt;/li>
&lt;/ul>
&lt;hr>
&lt;h2 id="问题解答">问题解答 &lt;a href="#%e9%97%ae%e9%a2%98%e8%a7%a3%e7%ad%94" class="anchor" aria-hidden="true">&lt;i class="material-icons align-middle">link&lt;/i>&lt;/a>&lt;/h2>&lt;p>HTTP方法的核心区别在于：&lt;/p>
&lt;ol>
&lt;li>&lt;strong>安全性&lt;/strong>：仅GET/HEAD/OPTIONS属于安全方法，不会产生副作用&lt;/li>
&lt;li>&lt;strong>幂等性&lt;/strong>：
&lt;ul>
&lt;li>GET/HEAD/OPTIONS/PUT/DELETE具有幂等性&lt;/li>
&lt;li>POST/PATCH不具备强制幂等保证&lt;/li>
&lt;/ul>
&lt;/li>
&lt;/ol>
&lt;p>PATCH在RESTful设计中的应用要点：&lt;/p>
&lt;ul>
&lt;li>应作为资源局部更新操作的首选方法（如修改用户邮箱）&lt;/li>
&lt;li>需配合条件请求（If-Match头）防止更新丢失问题&lt;/li>
&lt;li>业务层需确保补丁操作自身的幂等性（如使用JSON Patch的&lt;code>test&lt;/code>指令）&lt;/li>
&lt;/ul>
&lt;hr>
&lt;h2 id="解决方案">解决方案 &lt;a href="#%e8%a7%a3%e5%86%b3%e6%96%b9%e6%a1%88" class="anchor" aria-hidden="true">&lt;i class="material-icons align-middle">link&lt;/i>&lt;/a>&lt;/h2>&lt;h3 id="示例用户信息更新api">示例：用户信息更新API &lt;a href="#%e7%a4%ba%e4%be%8b%e7%94%a8%e6%88%b7%e4%bf%a1%e6%81%af%e6%9b%b4%e6%96%b0api" class="anchor" aria-hidden="true">&lt;i class="material-icons align-middle">link&lt;/i>&lt;/a>&lt;/h3>


 
 
 

 
 
 
 

 

 &lt;div class="prism-codeblock ">
 &lt;pre id="9aadb42" class="language-javascript ">
 &lt;code>// PATCH /users/123
// Headers: If-Match: &amp;#34;e123&amp;#34;
{
 &amp;#34;op&amp;#34;: &amp;#34;replace&amp;#34;,
 &amp;#34;path&amp;#34;: &amp;#34;/email&amp;#34;,
 &amp;#34;value&amp;#34;: &amp;#34;new@example.com&amp;#34;
}

// 服务端处理逻辑
app.patch(&amp;#39;/users/:id&amp;#39;, async (req, res) =&amp;gt; {
 const currentETag = await getResourceETag(req.params.id)
 if(req.headers[&amp;#39;if-match&amp;#39;] !== currentETag) {
 return res.status(412).send() // 前置条件失败
 }
 
 try {
 applyPatch(userData, req.body) // 应用JSON Patch
 const newETag = generateNewVersion()
 await saveWithOptimisticLock(userData, newETag)
 } catch (e) {
 // 处理冲突或非法操作
 }
})&lt;/code>
 &lt;/pre>
 &lt;/div>
&lt;h4 id="可扩展性建议">可扩展性建议 &lt;a href="#%e5%8f%af%e6%89%a9%e5%b1%95%e6%80%a7%e5%bb%ba%e8%ae%ae" class="anchor" aria-hidden="true">&lt;i class="material-icons align-middle">link&lt;/i>&lt;/a>&lt;/h4>&lt;ul>
&lt;li>高频场景：采用差分压缩减少传输数据量&lt;/li>
&lt;li>低端设备：限制补丁操作复杂度，服务端校验操作步骤&lt;/li>
&lt;li>分布式系统：结合向量时钟实现版本控制&lt;/li>
&lt;/ul>
&lt;hr>
&lt;h2 id="深度追问">深度追问 &lt;a href="#%e6%b7%b1%e5%ba%a6%e8%bf%bd%e9%97%ae" class="anchor" aria-hidden="true">&lt;i class="material-icons align-middle">link&lt;/i>&lt;/a>&lt;/h2>&lt;ol>
&lt;li>
&lt;p>&lt;strong>如何实现批量操作的幂等性？&lt;/strong>
使用客户端生成唯一请求ID，服务端建立请求日记&lt;/p></description></item></channel></rss>