Styles on Tarragonhttps://tarrragon.github.io/blog/tags/styles/Recent content in Styles on TarragonHugo -- gohugo.iozh-TWTarragon (CC BY 4.0)Fri, 03 Jul 2026 00:00:00 +0000API 風格流派層https://tarrragon.github.io/blog/backend/11-api-design/styles/Fri, 03 Jul 2026 00:00:00 +0000https://tarrragon.github.io/blog/backend/11-api-design/styles/<p>流派層收各 API 風格內部的深度交鋒、對應其他模組的 <code>vendors/</code> 慣例：每個流派一個目錄、文章用該流派自己的詞彙陳述論證、含該流派的失敗案例與適用邊界。中性判準層在 <a href="https://tarrragon.github.io/blog/backend/11-api-design/" data-link-title="模組十一：API 設計與對外契約" data-link-desc="整理 API 風格選型、資源建模、錯誤模型、版本與相容策略、冪等與對外流量語意的設計判準；主流做法與各流派的深度論證分層收錄">主章</a>、選型判讀從 <a href="https://tarrragon.github.io/blog/backend/11-api-design/api-style-selection/" data-link-title="11.2 風格選型總覽" data-link-desc="REST 式 HTTP&#43;JSON、GraphQL、gRPC、tRPC、JSON-RPC、event 之間選哪個 — 用消費者形狀、演進成本、操作可及性三軸判讀">11.2 風格選型總覽</a> 進入；讀者已熟悉主流做法、想看各流派怎麼為自己辯護時、直接從本層進入。</p> <table> <thead> <tr> <th>目錄</th> <th>主題</th> <th>狀態</th> </tr> </thead> <tbody> <tr> <td><a href="https://tarrragon.github.io/blog/backend/11-api-design/styles/rest/" data-link-title="REST 流派：語意學之爭與 hypermedia 復興" data-link-desc="REST 這個詞的定義權爭奪、hypermedia 路線的復興論證與業界拒絕的理由、成熟度模型的實用讀法">rest/</a></td> <td>REST 語意學之爭、hypermedia 復興、Richardson 成熟度</td> <td>已完成</td> </tr> <tr> <td><a href="https://tarrragon.github.io/blog/backend/11-api-design/styles/graphql/" data-link-title="GraphQL 流派：schema 演進、執行成本與公開 API 進退" data-link-desc="versionless 演進的紀律代價、resolver 執行模型的成本與攻擊面、大平台採用與撤退的情境差異">graphql/</a></td> <td>schema 演進、執行成本與安全、公開 API 的進退</td> <td>已完成</td> </tr> <tr> <td>grpc/</td> <td>proto 演進紀律、部署邊界、內部 RPC 選型</td> <td>backlog</td> </tr> <tr> <td>rpc-revival/</td> <td>tRPC 型別共享、JSON-RPC 重生場景</td> <td>backlog</td> </tr> <tr> <td>standards/</td> <td>JSON:API 與 OData、OpenAPI 與 AsyncAPI 生態</td> <td>backlog</td> </tr> <tr> <td>realtime/</td> <td>WebSocket / SSE / long-polling / webhook 的對外承諾差異</td> <td>案例待採集</td> </tr> </tbody> </table>流派層收各 API 風格內部的深度交鋒、對應其他模組的 vendors/ 慣例：每個流派一個目錄、文章用該流派自己的詞彙陳述論證、含該流派的失敗案例與適用邊界。中性判準層在 主章、選型判讀從 11.2 風格選型總覽 進入；讀者已熟悉主流做法、想看各流派怎麼為自己辯護時、直接從本層進入。

目錄 主題 狀態
rest/ REST 語意學之爭、hypermedia 復興、Richardson 成熟度 已完成
graphql/ schema 演進、執行成本與安全、公開 API 的進退 已完成
grpc/ proto 演進紀律、部署邊界、內部 RPC 選型 backlog
rpc-revival/ tRPC 型別共享、JSON-RPC 重生場景 backlog
standards/ JSON:API 與 OData、OpenAPI 與 AsyncAPI 生態 backlog
realtime/ WebSocket / SSE / long-polling / webhook 的對外承諾差異 案例待採集
]]>