<?xml version="1.0" encoding="UTF-8"?><rss xmlns:dc="http://purl.org/dc/elements/1.1/" xmlns:content="http://purl.org/rss/1.0/modules/content/" xmlns:atom="http://www.w3.org/2005/Atom" version="2.0" xmlns:cc="http://cyber.law.harvard.edu/rss/creativeCommonsRssModule.html">
    <channel>
        <title><![CDATA[Stories by D9niel Code on Medium]]></title>
        <description><![CDATA[Stories by D9niel Code on Medium]]></description>
        <link>https://medium.com/@d9niel.code?source=rss-b561bea4ab21------2</link>
        <image>
            <url>https://cdn-images-1.medium.com/fit/c/150/150/0*seYE8Y5tQhKIA-Pz</url>
            <title>Stories by D9niel Code on Medium</title>
            <link>https://medium.com/@d9niel.code?source=rss-b561bea4ab21------2</link>
        </image>
        <generator>Medium</generator>
        <lastBuildDate>Tue, 17 Nov 2026 10:27:01 GMT</lastBuildDate>
        <atom:link href="https://medium.com/@d9niel.code/feed" rel="self" type="application/rss+xml"/>
        <webMaster><![CDATA[yourfriends@medium.com]]></webMaster>
        <atom:link href="http://medium.superfeedr.com/" rel="hub"/>
        <item>
            <title><![CDATA[前端 API 呼叫策略]]></title>
            <link>https://medium.com/@d9niel.code/%E5%89%8D%E7%AB%AF-api-%E5%91%BC%E5%8F%AB%E7%AD%96%E7%95%A5-606762fecc61?source=rss-b561bea4ab21------2</link>
            <guid isPermaLink="false">https://medium.com/p/606762fecc61</guid>
            <category><![CDATA[web-development]]></category>
            <category><![CDATA[api]]></category>
            <category><![CDATA[cache]]></category>
            <category><![CDATA[strategy]]></category>
            <category><![CDATA[frontend]]></category>
            <dc:creator><![CDATA[D9niel Code]]></dc:creator>
            <pubDate>Wed, 30 Apr 2025 04:52:11 GMT</pubDate>
            <atom:updated>2025-04-30T04:52:11.259Z</atom:updated>
            <content:encoded><![CDATA[<p>在開發現代 Web 應用時，與 API 的互動已成為前端的核心任務之一。然而，隨著功能與規模的增加，我們也越來越容易遇到 API 相關的痛點與效能瓶頸。本篇文章將從實戰經驗出發，分享如何透過合理的 API Calling Strategy 來提升使用者體驗與系統穩定性。</p><h3>API 定義</h3><p>這邊理所當然是指 Web API，而不是在講廣義的 Application Programming Interface。那對於前端來說 API 存在的意義是什麼？</p><p>資料！沒錯就是資料，也可以說是「動態的資料」。我們 Frontend 在 Web 開發中最常打交道的對象，不外乎就是 UI 跟 Backend。而 Backend 提供我們的就是這些寶貴的資料！</p><p>接下來，我們來看看有哪些常見問題需要被解決</p><h3>常見 API 相關問題</h3><blockquote><strong><em>Overfetching / N+1 Requests</em></strong></blockquote><p>情境</p><ul><li>電商首頁顯示商品清單時，每個商品又各自再發 API 請求抓「評論數」或「庫存」。</li><li>進入商品詳細頁面時，除了核心的品名、數量、價格等資訊，還同時抓取了大量的詳細規格與圖片。</li></ul><p>可能的解法</p><ul><li>合併 API、使用 GraphQL</li><li>Lazy Fetching</li></ul><blockquote><strong><em>Missing Error Handling</em></strong></blockquote><p>情境</p><ul><li>表單送出後，API 回錯誤但畫面沒有顯示失敗（使用者不知道發生什麼事）。</li><li>明明 Auth Token 過期了得到 401 卻還在傻傻 retry。</li></ul><p>可能的解法</p><ul><li>記得寫 Error Handling（？）</li><li>把一些常見的 General Error 用 interceptor/middleware 做統一的 handle</li></ul><blockquote><strong><em>缺乏資料一致性機制</em></strong></blockquote><p>情境範例</p><ul><li>使用者更新個人資料後，側邊欄頭像沒變，重新整理才看到更新。</li></ul><p>可能的解法</p><ul><li><strong>共用</strong>快取層（TanStack Query/SWR/RTK Query）</li><li>透過 <strong>State Management System</strong> (Pinia/Zustand)</li></ul><blockquote><strong><em>Race Condition</em></strong></blockquote><p>情境範例</p><ul><li>使用者搜尋「a」→「ab」→「abc」很快輸入，結果出現的是「a」的結果（剛好較晚的請求先完成了）。</li></ul><p>可能的解法</p><ul><li>使用 Debounce and/or AbortController 終止前一個請求。</li><li>使用 latest-only 機制（如 TanStack Query 的 key overwrite）。</li></ul><h3>應對策略</h3><p>除了上面每個問題都有大概提出的解法以外，我們這邊也整理一些常使用的策略，讓大家可以概覽。想更詳細了解可以抓這些關鍵字去延伸閱讀！</p><blockquote><strong><em>Debounce/Throttle</em></strong></blockquote><p>Debounce：等使用者停下來才發送（搜尋框、filter）</p><p>Throttle：限制頻率（scroll event, window resize 時發送）</p><blockquote><strong><em>Cache</em></strong></blockquote><p>快取查詢結果，避免重複請求。既可省前端時間，又可以省後端麻煩，何樂而不為？不過記得設定過期的時間！以保持資料的新鮮度。</p><blockquote><strong><em>Error Handling/Retry</em></strong></blockquote><p>前面也提到了，這是滿容易被忽略的部分，API 一旦回報錯了之後，我們要怎麼處置，看是要讓使用者知道，還是要在背景 retry。如果要 Retry，要注意的事情就多很多了…</p><p>有些 API Error 在整個 Use Case 當中反而是正常的狀況，而非 Exception。像是沒登入卻按讚，當然這種情況可以預先擋掉，甚至不用等 401 。</p><h3>UI 策略</h3><blockquote>沒資料，那畫面怎麼辦</blockquote><blockquote><strong><em>Optimistic UI</em></strong></blockquote><figure><img alt="" src="https://cdn-images-1.medium.com/max/600/1*S5uv6kJsh8foCPpWLPKovg.png" /><figcaption>source: <a href="https://www.webdong.dev/en/post/optimistic-ui/">https://www.webdong.dev/en/post/optimistic-ui/</a></figcaption></figure><p>有些情況下，我們可以透過「立即回饋」使用者的操作，以提高使用者體驗，資料的同步可以推延執行。</p><p>像上面這種按讚的例子，我們可以結合 Debounce，讓按讚的 button 可以輕易的被反覆操作，獲得立即回饋的同時又不會真的重複呼叫相關 API。</p><blockquote><strong><em>Lazy Loading</em></strong></blockquote><p>延遲載入策略，讓資源在「需要時才載入」而不是一開始就全部下載。這可以減少初始頁面加載時間、提升<strong>效能與使用者體驗</strong>。常見應用包括圖片、模組、API 資料的 Lazy Loading。</p><p>也回歸到 API Calling Strategy，我們就可以讓比較優先度不高的 API 實施 Lazy Fetching！除了使用者體驗外，可以<strong>提高 SEO 表現</strong>！</p><blockquote><strong><em>Skeleton</em></strong></blockquote><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*kjiP2MlAkAuAiuYOr6BwLA.gif" /><figcaption>source: <a href="https://medium.com/design-bootcamp/how-ui-skeleton-loaders-improve-user-experience-real-world-examples-7279c7a2f858">https://medium.com/design-bootcamp/how-ui-skeleton-loaders-improve-user-experience-real-world-examples-7279c7a2f858</a></figcaption></figure><p>Skeleton 是一種 UI loading 效果，用「灰色 placeholder」模擬內容結構，在資料尚未載入時先佔位。它能讓使用者感覺畫面更快出現、減少全白畫面的不適感。常搭配 lazy loading 使用，<strong>提升感知效能與體驗</strong>。</p><p>比起一概的用 Spinner 在那邊轉轉轉，Skeleton 能給使用者更多資訊的提早感知（知道 Layout，知道正在載入什麼樣的資料，知道有沒有進錯頁面）。</p><h3>進階策略</h3><p>：誒前面不是講過策略了，還要介紹什麼？</p><p>其實還有一些比較複雜、甚至用不好是雙面刃的方法，也一併介紹給大家。</p><blockquote><strong><em>Prefetching</em></strong></blockquote><p>欸不是啊，我們不是要減少不必要的呼叫，能延遲呼叫就慢點呼叫嗎？</p><p>是沒錯，塞車的時候希望少一點車。但如果現在車少，那安排一些車先上路也未嘗不可？</p><p>進階的技術往往是雙面刃，預先拿取資料可以提升載入速度（命中時），但設計不好命中率低就是浪費頻寬 🫠</p><p>為了提供我們有好的策略做 prefetching，需要理解使用者的習慣，當使用者肚子裡的蛔蟲！</p><blockquote><strong><em>Batching/Aggregation</em></strong></blockquote><p>除了前端在呼叫上做調整，其實我們還可以請後端幫忙！不過後端設計的 API 需要支援批次處理，或者採取 GraphQL。</p><p>Aggregator Pattern：更重後端設計，彈性較差</p><p>GraphQL：前端自助餐，彈性較好，但更需要額外學習。</p><p>我們為何需要使用？</p><ul><li>減少打 API 的次數，降低 overhead</li><li>方便同步 Pending 狀態</li></ul><blockquote><strong><em>Retry Mechanism</em></strong></blockquote><p>Retry 並不算是雙面刃，但很吃特定情境，要做到什麼程度才有足夠效益也需要更綜合的評估，下面我們簡單的看看。</p><blockquote>有 哪 些 情 況 適 合 Retry<strong>?</strong></blockquote><ul><li>網路不穩／移動裝置使用者在 4G、地鐵、Wi-Fi 斷續時，請求偶爾失敗</li><li>背景同步任務非即時任務，如 background polling、token refresh</li><li>短時間內臨時失效伺服器偶爾 503、Cloudflare 或 edge network 小當機</li><li>表單送出後未立即返回像留言或送出意見，使用者點擊後結果沒回來可以重試一次</li></ul><blockquote>使 用<strong> Retry </strong>時 的 注 意 事 項</blockquote><p>❌ 不適合重複性的動作（not <strong>idempotent</strong>）刷新讚、按下購物按鈕 → 若 retry 多次可能造成資料錯誤</p><p>🧠 要設定 retry <strong>間隔與次數</strong>避免過度重試造成 server overload（如每 100ms retry 一次）</p><p>📉 要搭配 backoff 策略常見如 exponential backoff：500ms → 1s → 2s，可減緩伺服器壓力</p><p>📍 <strong>判斷 retry 條件</strong>只 retry network error / 5xx，避免 retry 使用者輸入錯誤（4xx）</p><p>🧵 <strong>不建議 retry 並發</strong>多筆請求若多個 API 同時 retry，會造成 network 暴增與效能下降</p><h3>結語</h3><p>有效的 API 呼叫策略，不只是為了減少請求與加快畫面，更是前端工程品質與使用者體驗的關鍵。希望這份策略整理，能幫助你在實戰中更精準地選擇合適的技巧與工具。</p><p>如果你有其他好用的 API 管理經驗，也歡迎留言或分享給你的開發夥伴 👋</p><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=606762fecc61" width="1" height="1" alt="">]]></content:encoded>
        </item>
    </channel>
</rss>