<?xml version="1.0" encoding="utf-8" standalone="yes"?>
<rss version="2.0" xmlns:atom="http://www.w3.org/2005/Atom">
	<channel>
		<title>GRPC on Bill.Lin&#39;s Notes</title>
		<link>https://xinqilin.github.io/tags/grpc/</link>
		<description>Recent content in GRPC on Bill.Lin&#39;s Notes</description>
		<generator>Hugo</generator>
		<language>zh-tw</language>
		
		
		
		
			<lastBuildDate>Sun, 22 Nov 2026 00:00:00 +0800</lastBuildDate>
		
			<atom:link href="https://xinqilin.github.io/tags/grpc/index.xml" rel="self" type="application/rss+xml" />
			<item>
				<title>REST、gRPC 與 GraphQL：依呼叫者選擇 API 風格</title>
				<link>https://xinqilin.github.io/post/systemdesign/rest-grpc-graphql/</link>
				<pubDate>Sun, 22 Nov 2026 00:00:00 +0800</pubDate>
				<guid>https://xinqilin.github.io/post/systemdesign/rest-grpc-graphql/</guid>
				<description>&lt;blockquote&gt;&#xA;&lt;p&gt;&lt;strong&gt;System Design 系列&lt;/strong&gt; Part 5-1｜上一篇：&lt;a href=&#34;https://xinqilin.github.io/post/systemdesign/distributed-lock/&#34;&gt;分散式鎖與 Fencing Token&lt;/a&gt;｜下一篇：&lt;a href=&#34;https://xinqilin.github.io/post/systemdesign/message-queue/&#34;&gt;Message Queue&lt;/a&gt;｜&lt;a href=&#34;https://xinqilin.github.io/post/systemdesign/system-design-thinking/#%E7%B3%BB%E5%88%97%E5%9C%B0%E5%9C%96&#34;&gt;系列地圖&lt;/a&gt;&lt;/p&gt;&#xA;&lt;/blockquote&gt;&#xA;&lt;h2 id=&#34;情境與問題&#34;&gt;情境與問題&lt;/h2&gt;&#xA;&lt;p&gt;講座平台拆成報名、講座、通知幾個服務之後，API 的呼叫者分成三種，需求很不一樣：&lt;/p&gt;&#xA;&lt;ol&gt;&#xA;&lt;li&gt;&lt;strong&gt;合作夥伴&lt;/strong&gt;：企業客戶用 API 查詢講座、替員工報名。他們用什麼語言、什麼工具都有可能，最在意的是好上手、穩定、文件清楚&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;自家 App 的首頁&lt;/strong&gt;：一個畫面要顯示講座、講者、剩餘名額、我的報名狀態。不同版本的 App、不同的畫面，要的欄位都不一樣，而且行動網路的每一次往返都很貴&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;服務之間&lt;/strong&gt;：報名服務每次報名都要向講座服務確認名額與時間，尖峰每秒數千次；講者後台還要即時看到新的報名，需要伺服器主動推送&lt;/li&gt;&#xA;&lt;/ol&gt;&#xA;&lt;h2 id=&#34;最簡單的做法與它的極限&#34;&gt;最簡單的做法與它的極限&lt;/h2&gt;&#xA;&lt;p&gt;全部用 REST + JSON：&lt;/p&gt;&#xA;&lt;ul&gt;&#xA;&lt;li&gt;&lt;strong&gt;App 首頁&lt;/strong&gt;：要打 4、5 支 API 才湊得齊一個畫面。為首頁做一支專用 API 可以解決，但每個畫面、每個 App 版本都要一支，API 數量一直膨脹；共用同一支 API，又會回傳很多用不到的欄位&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;服務之間&lt;/strong&gt;：每次呼叫都要序列化與解析 JSON；欄位改名或型別改變，要到執行時才發現；也沒有內建的機制把「呼叫端還願意等多久」傳給下游&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;即時推送&lt;/strong&gt;：HTTP 的一問一答模式不適合長時間的串流&lt;/li&gt;&#xA;&lt;/ul&gt;&#xA;&lt;p&gt;這不代表 REST 不好，而是不同的呼叫者適合不同的工具。&lt;/p&gt;&#xA;&lt;h2 id=&#34;核心機制&#34;&gt;核心機制&lt;/h2&gt;&#xA;&lt;h3 id=&#34;rest用-http-本身的語意&#34;&gt;REST：用 HTTP 本身的語意&lt;/h3&gt;&#xA;&lt;p&gt;REST 以&lt;strong&gt;資源&lt;/strong&gt;為中心，用 HTTP 方法表達操作。它最大的優勢是能直接利用整個 HTTP 生態：瀏覽器、curl、CDN、反向代理、快取都看得懂。&lt;/p&gt;&#xA;&lt;p&gt;HTTP 規格（RFC 9110）對每個方法有明確的語意，這些語意會影響快取與重試：&lt;/p&gt;&#xA;&lt;table&gt;&#xA;&#x9;&lt;thead&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;th&gt;方法&lt;/th&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;th&gt;安全（不改變狀態）&lt;/th&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;th&gt;冪等（執行多次結果相同）&lt;/th&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;th&gt;用途&lt;/th&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&lt;/thead&gt;&#xA;&#x9;&lt;tbody&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;GET、HEAD&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;是&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;是&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;讀取，可以快取，失敗可以直接重試&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;PUT&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;否&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;是&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;整份取代&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;DELETE&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;否&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;是&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;刪除&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;POST&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;否&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;否&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;建立、或其他不符合上述語意的操作&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;PATCH&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;否&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;不一定&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;部分更新&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&lt;/tbody&gt;&#xA;&lt;/table&gt;&#xA;&lt;p&gt;POST 不是冪等的，網路逾時後重試可能建立兩筆資料。建立類的 POST 要支援 &lt;code&gt;Idempotency-Key&lt;/code&gt;，&lt;a href=&#34;https://xinqilin.github.io/post/systemdesign/idempotency-key/&#34;&gt;Part 5 的冪等性篇&lt;/a&gt;會詳談。&lt;/p&gt;</description>
			</item>
	</channel>
</rss>
