API 呼叫紀錄

查看所有透過 API 呼叫 MaiAgent 服務的完整記錄，包含請求內容、回應結果與效能數據

功能說明

API 呼叫紀錄提供您透過 MaiAgent API 進行的所有請求的完整記錄，包含 HTTP 方法、端點路徑、狀態碼、回應時間、請求與回應內容等資訊。適合開發人員在串接 API 時進行除錯、效能監控與用量追蹤。

---

查看紀錄

在左側選單點選 開發者 → API 呼叫紀錄，即可查看所有 API 請求的記錄列表。

記錄欄位說明

欄位	說明
ID	請求的唯一識別碼，可點選複製
方法	HTTP 方法（GET、POST、PUT、DELETE、PATCH），以不同顏色標示
端點	API 端點路徑
狀態碼	HTTP 回應狀態碼，依類型顏色標示：2xx（綠色）、4xx（橘色）、5xx（紅色）
延遲	請求耗時，依速度顏色標示：100ms 以下（綠色）、100～500ms（橘色）、500ms 以上（紅色）；超過 1 秒時以秒顯示
請求 Body	請求內容預覽
回應 Body	回應內容預覽
IP	發送請求的來源 IP
時間	請求時間

---

篩選與搜尋

使用頂部的篩選列快速找到需要的紀錄：

• 日期範圍：選擇起始與結束日期，查看特定時段的紀錄

• 方法：依 HTTP 方法篩選（GET、POST、PUT、DELETE、PATCH），預設為 全部方法

• 狀態分類：依回應狀態篩選（2xx 成功、4xx 客戶端錯誤、5xx 伺服器錯誤），預設為 全部狀態碼

• 搜尋：輸入端點、金鑰名稱或 IP 搜尋

排查 API 串接問題時，建議先篩選 4xx 或 5xx 狀態碼，快速定位失敗的請求。

---

查看請求詳情

在記錄列表中，點擊任一筆紀錄右側的檢視圖示，開啟 查看詳情 視窗，方便開發人員除錯：

• 基本資訊：請求 ID、時間、方法、狀態碼、延遲、IP 位址、端點與 User-Agent

• 請求 Headers、請求 Body：完整的請求內容

• 回應 Headers、回應 Body：完整的回應內容

• 錯誤：請求發生錯誤時才會出現，顯示錯誤訊息