# API 呼叫紀錄

## 功能說明

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

<figure><img src="https://1593648278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fmzb5NG9GDzFP2YDKeYVl%2Fuploads%2Fgit-blob-c984875573ba7b4a2b1866acc0c60fa29dbd0899%2Fdeveloper-api-logs.png?alt=media" alt=""><figcaption><p>API 呼叫紀錄頁面</p></figcaption></figure>

***

## 查看紀錄

在左側選單點選 <mark style="color:blue;">開發者</mark> → <mark style="color:blue;">API 呼叫紀錄</mark>，即可查看所有 API 請求的記錄列表。

### 記錄欄位說明

| 欄位                | 說明                                            |
| ----------------- | --------------------------------------------- |
| **ID**            | 請求的唯一識別碼                                      |
| **Method**        | HTTP 方法（GET、POST、PUT、DELETE、PATCH），以不同顏色標示    |
| **Endpoint**      | API 端點路徑                                      |
| **Status Code**   | HTTP 回應狀態碼，依類型顏色標示：2xx（綠色）、4xx（橘色）、5xx（紅色）    |
| **Duration**      | 請求耗時，依速度顏色標示：<100ms（綠色）、<500ms（橘色）、>500ms（紅色） |
| **Request Body**  | 請求內容預覽                                        |
| **Response Body** | 回應內容預覽                                        |
| **IP Address**    | 發送請求的來源 IP                                    |
| **Time**          | 請求時間                                          |

***

## 篩選與搜尋

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

* **日期範圍**：選擇起始與結束日期，查看特定時段的紀錄
* **HTTP Method**：依方法篩選（GET、POST、PUT、DELETE、PATCH）
* **狀態類別**：依回應狀態篩選（2xx 成功、4xx 客戶端錯誤、5xx 伺服器錯誤）
* **關鍵字搜尋**：輸入端點路徑或其他關鍵字搜尋

{% hint style="info" %}
排查 API 串接問題時，建議先篩選 4xx 或 5xx 狀態碼，快速定位失敗的請求。
{% endhint %}

***

## 查看請求詳情

在記錄列表中，點擊任一筆紀錄右側的檢視圖示，即可展開完整的請求與回應詳情，包含完整的 Request Body 和 Response Body，方便開發人員除錯。