<?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 ChiYu Code Journey</title><link>https://huangchiyu.com/ChiYu-Blog/categories/api-%E8%A8%AD%E8%A8%88/</link><description>Recent content in API 設計 on ChiYu Code Journey</description><generator>Hugo -- gohugo.io</generator><language>zh-TW</language><lastBuildDate>Wed, 30 Sep 2026 09:16:47 +0800</lastBuildDate><atom:link href="https://huangchiyu.com/ChiYu-Blog/categories/api-%E8%A8%AD%E8%A8%88/index.xml" rel="self" type="application/rss+xml"/><item><title>Day 01｜網站真的會被 Agent 使用嗎？我先丟了一句自然語言</title><link>https://huangchiyu.com/ChiYu-Blog/posts/webmcp-agent-ready-day-01/</link><pubDate>Tue, 01 Sep 2026 08:37:07 +0800</pubDate><guid>https://huangchiyu.com/ChiYu-Blog/posts/webmcp-agent-ready-day-01/</guid><description>本文同步自 2026 iThome 鐵人賽原文 。完整系列可見 iThome 系列頁 。 安安～我是ChiYu～ 今年我想拿一個很新的 Web API，做一件很老派的事：實際把它做完，再看看它</description></item><item><title>Day 02｜換到全新資料夾後，網站還能不能跑？</title><link>https://huangchiyu.com/ChiYu-Blog/posts/webmcp-agent-ready-day-02/</link><pubDate>Wed, 02 Sep 2026 08:01:23 +0800</pubDate><guid>https://huangchiyu.com/ChiYu-Blog/posts/webmcp-agent-ready-day-02/</guid><description>本文同步自 2026 iThome 鐵人賽原文 。完整系列可見 iThome 系列頁 。 安安～我是ChiYu～ 昨天才把完成版的 Agent trace 端上桌，今天我做的第一件事，卻是把它收起來。 我另外</description></item><item><title>Day 03｜先別急著做 Tool，我把活動網站自己走了一遍</title><link>https://huangchiyu.com/ChiYu-Blog/posts/webmcp-agent-ready-day-03/</link><pubDate>Thu, 03 Sep 2026 08:05:00 +0800</pubDate><guid>https://huangchiyu.com/ChiYu-Blog/posts/webmcp-agent-ready-day-03/</guid><description>本文同步自 2026 iThome 鐵人賽原文 。完整系列可見 iThome 系列頁 。 安安～我是ChiYu～ 昨天把專案切到固定 tag，Web、API、測試和 build 也都跑起來了。照這個</description></item><item><title>Day 04｜按鈕只多包一層，哪種 Playwright Locator 撐得住？</title><link>https://huangchiyu.com/ChiYu-Blog/posts/webmcp-agent-ready-day-04/</link><pubDate>Fri, 04 Sep 2026 08:02:12 +0800</pubDate><guid>https://huangchiyu.com/ChiYu-Blog/posts/webmcp-agent-ready-day-04/</guid><description>本文同步自 2026 iThome 鐵人賽原文 。完整系列可見 iThome 系列頁 。 安安～我是ChiYu～ 昨天我把活動網站從搜尋一路走到取消報名，最後挑了風險最低的搜尋流程，準</description></item><item><title>Day 05｜只改按鈕四個字，Playwright 為什麼停在 click 以前？</title><link>https://huangchiyu.com/ChiYu-Blog/posts/webmcp-agent-ready-day-05/</link><pubDate>Sat, 05 Sep 2026 12:09:29 +0800</pubDate><guid>https://huangchiyu.com/ChiYu-Blog/posts/webmcp-agent-ready-day-05/</guid><description>本文同步自 2026 iThome 鐵人賽原文 。完整系列可見 iThome 系列頁 。 安安～我是ChiYu～ 昨天我在搜尋按鈕外多包一層元素，getByRole() 仍然順利找到它。</description></item><item><title>Day 06｜Playwright、REST API、MCP 與 WebMCP，各自負責哪一段？</title><link>https://huangchiyu.com/ChiYu-Blog/posts/webmcp-agent-ready-day-06/</link><pubDate>Sun, 06 Sep 2026 12:28:54 +0800</pubDate><guid>https://huangchiyu.com/ChiYu-Blog/posts/webmcp-agent-ready-day-06/</guid><description>本文同步自 2026 iThome 鐵人賽原文 。完整系列可見 iThome 系列頁 。 安安～我是ChiYu～ 昨天 Playwright 因為按鈕改名而停在 click 以前。看到這個結果，很容易順手得出一個省事的</description></item><item><title>Day 07｜Agent 偶爾答對還不夠，我先出二十道測試題</title><link>https://huangchiyu.com/ChiYu-Blog/posts/webmcp-agent-ready-day-07/</link><pubDate>Mon, 07 Sep 2026 21:35:21 +0800</pubDate><guid>https://huangchiyu.com/ChiYu-Blog/posts/webmcp-agent-ready-day-07/</guid><description>本文同步自 2026 iThome 鐵人賽原文 。完整系列可見 iThome 系列頁 。 安安～我是ChiYu～ 昨天把 E0～E5 的證據等級排好後，我正準備動手寫第一支 WebMCP Tool，卻發</description></item><item><title>Day 08｜WebMCP Tool 該怎麼設計？把「點按鈕」改成「搜尋活動」</title><link>https://huangchiyu.com/ChiYu-Blog/posts/webmcp-agent-ready-day-08/</link><pubDate>Tue, 08 Sep 2026 10:19:06 +0800</pubDate><guid>https://huangchiyu.com/ChiYu-Blog/posts/webmcp-agent-ready-day-08/</guid><description>本文同步自 2026 iThome 鐵人賽原文 。完整系列可見 iThome 系列頁 。 安安～我是ChiYu～ 昨天才把二十道測試題出好，今天輪到我寫第一份答案。我從最單純的搜尋活動</description></item><item><title>Day 09｜網站該公開哪些 WebMCP Tool？從操作盤點到五支正式能力</title><link>https://huangchiyu.com/ChiYu-Blog/posts/webmcp-agent-ready-day-09/</link><pubDate>Wed, 09 Sep 2026 11:35:37 +0800</pubDate><guid>https://huangchiyu.com/ChiYu-Blog/posts/webmcp-agent-ready-day-09/</guid><description>本文同步自 2026 iThome 鐵人賽原文 。完整系列可見 iThome 系列頁 。 安安～我是ChiYu～ 昨天才把 click_blue_search_button 請出 catalog，我差點又用同一套方法，把剩下的按鈕 全部包</description></item><item><title>Day 10｜Inspector 裝好了，為什麼 Tool 面板還是一片空白？</title><link>https://huangchiyu.com/ChiYu-Blog/posts/webmcp-agent-ready-day-10/</link><pubDate>Thu, 10 Sep 2026 11:10:53 +0800</pubDate><guid>https://huangchiyu.com/ChiYu-Blog/posts/webmcp-agent-ready-day-10/</guid><description>本文同步自 2026 iThome 鐵人賽原文 。完整系列可見 iThome 系列頁 。 安安～我是ChiYu～ 昨天才把五支 Tool 的名單定下來，我原本以為今天打開 Inspector，它們</description></item><item><title>Day 10: 【文件 #5】溝通的契約：用 Gemini 撰寫「Web API 規格書」</title><link>https://huangchiyu.com/ChiYu-Blog/posts/2025ithomeironmanday10/</link><pubDate>Fri, 29 Aug 2025 00:00:00 +0800</pubDate><guid>https://huangchiyu.com/ChiYu-Blog/posts/2025ithomeironmanday10/</guid><description>安安，我是 ChiYu！ 昨天，我們完成了餐廳的「食材倉庫」設計圖——資料庫綱要。至此，我們專案的願景、使用者需求、系統架構、數據儲存方式，都已</description></item><item><title>Day 11｜什麼是 Declarative API？讓 HTML 表單成為 WebMCP Tool</title><link>https://huangchiyu.com/ChiYu-Blog/posts/webmcp-agent-ready-day-11/</link><pubDate>Fri, 11 Sep 2026 10:34:14 +0800</pubDate><guid>https://huangchiyu.com/ChiYu-Blog/posts/webmcp-agent-ready-day-11/</guid><description>本文同步自 2026 iThome 鐵人賽原文 。完整系列可見 iThome 系列頁 。 安安～我是ChiYu～ 昨天打開 Inspector 後，Chrome 終於把目前頁面的 Tool 列了出來。面板裡有名稱、d</description></item><item><title>Day 12｜Tool 註冊完還不算完成：離開 route 後誰把它收回來？</title><link>https://huangchiyu.com/ChiYu-Blog/posts/webmcp-agent-ready-day-12/</link><pubDate>Sat, 12 Sep 2026 09:09:19 +0800</pubDate><guid>https://huangchiyu.com/ChiYu-Blog/posts/webmcp-agent-ready-day-12/</guid><description>本文同步自 2026 iThome 鐵人賽原文 。完整系列可見 iThome 系列頁 。 安安～我是ChiYu～ 昨天的 Declarative API 很適合表單：HTML 還在，Tool 就跟著存在；表單離開頁面，</description></item><item><title>Day 13｜第一次按下 Inspector 的 Send，先被 Gemini 429 擋在門外</title><link>https://huangchiyu.com/ChiYu-Blog/posts/webmcp-agent-ready-day-13/</link><pubDate>Sun, 13 Sep 2026 10:59:26 +0800</pubDate><guid>https://huangchiyu.com/ChiYu-Blog/posts/webmcp-agent-ready-day-13/</guid><description>本文同步自 2026 iThome 鐵人賽原文 。完整系列可見 iThome 系列頁 。 安安～我是ChiYu～ 前天讓 HTML 表單透過 Declarative API 描述自己，昨天再用 Imperative API 管理動態 Tool 的註冊與解除。Ch</description></item><item><title>Day 14｜五支 Tool 不再往外長：把產品範圍寫成會亮紅燈的契約</title><link>https://huangchiyu.com/ChiYu-Blog/posts/webmcp-agent-ready-day-14/</link><pubDate>Mon, 14 Sep 2026 14:17:04 +0800</pubDate><guid>https://huangchiyu.com/ChiYu-Blog/posts/webmcp-agent-ready-day-14/</guid><description>本文同步自 2026 iThome 鐵人賽原文 。完整系列可見 iThome 系列頁 。 安安～我是ChiYu～ 昨天終於讓 Inspector 自己選中 search_events，留下第一筆完整自然語言</description></item><item><title>Day 15｜讓人類與 Agent 共用同一套活動搜尋規則</title><link>https://huangchiyu.com/ChiYu-Blog/posts/webmcp-agent-ready-day-15/</link><pubDate>Tue, 15 Sep 2026 10:43:54 +0800</pubDate><guid>https://huangchiyu.com/ChiYu-Blog/posts/webmcp-agent-ready-day-15/</guid><description>本文同步自 2026 iThome 鐵人賽原文 。完整系列可見 iThome 系列頁 。 安安～我是ChiYu～ 昨天把網站範圍鎖定在五支 Tool 與三條活動流程，也留下可以重播的正式搜尋基線</description></item><item><title>Day 16｜Agent 怎麼知道「我現在看的活動」是哪一場？</title><link>https://huangchiyu.com/ChiYu-Blog/posts/webmcp-agent-ready-day-16/</link><pubDate>Wed, 16 Sep 2026 08:16:04 +0800</pubDate><guid>https://huangchiyu.com/ChiYu-Blog/posts/webmcp-agent-ready-day-16/</guid><description>本文同步自 2026 iThome 鐵人賽原文 。完整系列可見 iThome 系列頁 。 安安～我是ChiYu～ 昨天的 search_events 已經找到「WebMCP 入門工作坊」，還順便帶回一個不透明的活動</description></item><item><title>Day 17｜Tool 回太少做不完，回太多又把內部資料倒給 Agent</title><link>https://huangchiyu.com/ChiYu-Blog/posts/webmcp-agent-ready-day-17/</link><pubDate>Thu, 17 Sep 2026 08:43:01 +0800</pubDate><guid>https://huangchiyu.com/ChiYu-Blog/posts/webmcp-agent-ready-day-17/</guid><description>本文同步自 2026 iThome 鐵人賽原文 。完整系列可見 iThome 系列頁 。 安安～我是ChiYu～ 昨天的 get_event_details 終於不用再猜 current，可以從目前頁面找到正確活動。照理說</description></item><item><title>Day 18｜活動服務暫時失敗時，Agent 應該重試還是停下來？</title><link>https://huangchiyu.com/ChiYu-Blog/posts/webmcp-agent-ready-day-18/</link><pubDate>Fri, 18 Sep 2026 08:49:31 +0800</pubDate><guid>https://huangchiyu.com/ChiYu-Blog/posts/webmcp-agent-ready-day-18/</guid><description>本文同步自 2026 iThome 鐵人賽原文 。完整系列可見 iThome 系列頁 。 安安～我是ChiYu～ 昨天才把成功 payload 收乾淨，今天我就準備把活動 API 暫時弄壞。 原本的計畫很單純：</description></item><item><title>Day 19｜同一場活動收藏兩次，網站為什麼只能留下同一筆？</title><link>https://huangchiyu.com/ChiYu-Blog/posts/webmcp-agent-ready-day-19/</link><pubDate>Sat, 19 Sep 2026 10:48:25 +0800</pubDate><guid>https://huangchiyu.com/ChiYu-Blog/posts/webmcp-agent-ready-day-19/</guid><description>本文同步自 2026 iThome 鐵人賽原文 。完整系列可見 iThome 系列頁 。 安安～我是ChiYu～ 昨天把唯讀失敗拆成「該停止」與「可以稍後重試」，也確認 Agent 不能一遇到錯誤</description></item><item><title>Day 20｜表單填好了，為什麼這次報名仍然不能算通過？</title><link>https://huangchiyu.com/ChiYu-Blog/posts/webmcp-agent-ready-day-20/</link><pubDate>Sun, 20 Sep 2026 10:54:06 +0800</pubDate><guid>https://huangchiyu.com/ChiYu-Blog/posts/webmcp-agent-ready-day-20/</guid><description>本文同步自 2026 iThome 鐵人賽原文 。完整系列可見 iThome 系列頁 。 安安～我是ChiYu～ 昨天的 save_event 就算重複呼叫，最多也是回我一句「這個已經收藏過了」。今天要碰的</description></item><item><title>Day 21｜一句「這個我不要了」，Agent 到底敢不敢直接取消？</title><link>https://huangchiyu.com/ChiYu-Blog/posts/webmcp-agent-ready-day-21/</link><pubDate>Mon, 21 Sep 2026 07:41:03 +0800</pubDate><guid>https://huangchiyu.com/ChiYu-Blog/posts/webmcp-agent-ready-day-21/</guid><description>本文同步自 2026 iThome 鐵人賽原文 。完整系列可見 iThome 系列頁 。 安安～我是ChiYu～ 昨天確認 Agent 能把報名資料填進表單，並在正式送出前停下來。我原本以為，把同</description></item><item><title>Day 22｜五支 Tool 如何共用同一套規則，串成三條完整流程？</title><link>https://huangchiyu.com/ChiYu-Blog/posts/webmcp-agent-ready-day-22/</link><pubDate>Tue, 22 Sep 2026 08:00:30 +0800</pubDate><guid>https://huangchiyu.com/ChiYu-Blog/posts/webmcp-agent-ready-day-22/</guid><description>本文同步自 2026 iThome 鐵人賽原文 。完整系列可見 iThome 系列頁 。 安安～我是ChiYu～ 昨天把取消報名接上之後，產品層的 catalog 終於湊齊五支 Tool。搜尋、詳情、收</description></item><item><title>Day 23｜在問 Agent 聰不聰明前，先證明網站沒有壞</title><link>https://huangchiyu.com/ChiYu-Blog/posts/webmcp-agent-ready-day-23/</link><pubDate>Wed, 23 Sep 2026 07:56:46 +0800</pubDate><guid>https://huangchiyu.com/ChiYu-Blog/posts/webmcp-agent-ready-day-23/</guid><description>本文同步自 2026 iThome 鐵人賽原文 。完整系列可見 iThome 系列頁 。 安安～我是ChiYu～ 昨天把五個 Tool 全部排好位置後，我很聽話地進入 feature freeze：不加第六個 T</description></item><item><title>Day 24｜活動摘要叫 Agent 洩漏祕密，它會把這句話當資料還是命令？</title><link>https://huangchiyu.com/ChiYu-Blog/posts/webmcp-agent-ready-day-24/</link><pubDate>Thu, 24 Sep 2026 08:42:00 +0800</pubDate><guid>https://huangchiyu.com/ChiYu-Blog/posts/webmcp-agent-ready-day-24/</guid><description>本文同步自 2026 iThome 鐵人賽原文 。完整系列可見 iThome 系列頁 。 安安～我是ChiYu～ 昨天才把自動化測試與 Agent trace 分開，今天我就在活動摘要裡塞進一句很不安分的話</description></item><item><title>Day 25｜localhost 成功不算交付：怎麼證明公開網址跑的是同一份程式？</title><link>https://huangchiyu.com/ChiYu-Blog/posts/webmcp-agent-ready-day-25/</link><pubDate>Fri, 25 Sep 2026 00:50:56 +0800</pubDate><guid>https://huangchiyu.com/ChiYu-Blog/posts/webmcp-agent-ready-day-25/</guid><description>本文同步自 2026 iThome 鐵人賽原文 。完整系列可見 iThome 系列頁 。 安安～我是ChiYu～ 前兩天在本機把程式基線與安全防線分開驗過，今天終於把同一份 release 推上 Azure Container A</description></item><item><title>Day 26｜把自然語言送進公開站，Agent 真的會自己選對 Tool 嗎？</title><link>https://huangchiyu.com/ChiYu-Blog/posts/webmcp-agent-ready-day-26/</link><pubDate>Sat, 26 Sep 2026 00:52:44 +0800</pubDate><guid>https://huangchiyu.com/ChiYu-Blog/posts/webmcp-agent-ready-day-26/</guid><description>本文同步自 2026 iThome 鐵人賽原文 。完整系列可見 iThome 系列頁 。 安安～我是ChiYu～ 昨天把 source commit、image digest 與 Azure revision 對齊後，我終於可以放心按下 Inspector 的</description></item><item><title>Day 27｜寫入型 Tool 怎麼驗收？把 Trace、Network、UI 與 Server 狀態放在一起看</title><link>https://huangchiyu.com/ChiYu-Blog/posts/webmcp-agent-ready-day-27/</link><pubDate>Sun, 27 Sep 2026 00:54:00 +0800</pubDate><guid>https://huangchiyu.com/ChiYu-Blog/posts/webmcp-agent-ready-day-27/</guid><description>本文同步自 2026 iThome 鐵人賽原文 。完整系列可見 iThome 系列頁 。 安安～我是ChiYu～ 昨天的兩個唯讀任務很好判斷：Agent 選對 Tool，輸入正確，回答也能</description></item><item><title>Day 28｜Agent 選錯、傳錯或答錯時，怎麼知道問題卡在哪一層？</title><link>https://huangchiyu.com/ChiYu-Blog/posts/webmcp-agent-ready-day-28/</link><pubDate>Mon, 28 Sep 2026 21:53:05 +0800</pubDate><guid>https://huangchiyu.com/ChiYu-Blog/posts/webmcp-agent-ready-day-28/</guid><description>本文同步自 2026 iThome 鐵人賽原文 。完整系列可見 iThome 系列頁 。 安安～我是ChiYu～ 昨天把唯讀與寫入任務跑過一輪後，我手上多了不少 trace，也多了不少長</description></item><item><title>Day 29｜把網站交給 Agent 前，我最後會檢查哪十件事？</title><link>https://huangchiyu.com/ChiYu-Blog/posts/webmcp-agent-ready-day-29/</link><pubDate>Tue, 29 Sep 2026 09:11:33 +0800</pubDate><guid>https://huangchiyu.com/ChiYu-Blog/posts/webmcp-agent-ready-day-29/</guid><description>本文同步自 2026 iThome 鐵人賽原文 。完整系列可見 iThome 系列頁 。 安安～我是ChiYu～ 昨天把失敗分成六層後，至少每一條 trace 都知道該往哪裡查了。今天我原本想順勢</description></item><item><title>Day 30｜網站終於會說話：做完五支 Tool 後，我學到什麼？</title><link>https://huangchiyu.com/ChiYu-Blog/posts/webmcp-agent-ready-day-30/</link><pubDate>Wed, 30 Sep 2026 09:16:47 +0800</pubDate><guid>https://huangchiyu.com/ChiYu-Blog/posts/webmcp-agent-ready-day-30/</guid><description>本文同步自 2026 iThome 鐵人賽原文 。完整系列可見 iThome 系列頁 。 安安～我是ChiYu～ 昨天做完交付檢查，最後留下的答案有點不乾脆：如果交付的是 Demo、To</description></item></channel></rss>