> ## Documentation Index
> Fetch the complete documentation index at: https://docs.fluz.app/llms.txt
> Use this file to discover all available pages before exploring further.

# 總覽

為了使用 Fluz API 購買禮品卡，您需要先決定要使用的商家與優惠。Fluz 提供兩種方式存取我們的商家目錄，適用於不同情境：

1. **完整商家清單與優惠：** 取得所有可用商家及其優惠的完整清單。
2. **最佳費率查詢：** 輕鬆找出特定商家的可用最佳費率。在開始使用目錄之前，請先了解以下重要細節。

> 🚧 現金回饋費率可能變動。
>
> 我們致力於為客戶提供最佳可用優惠。因此，我們的費率會定期調整。請務必在購買前再次確認費率。

## 目錄請求中的費率設定

目錄中的費率會依您的帳戶進行客製化。如果您的帳戶擁有任何專屬優惠，這些內容會反映在 `offer` 物件的 `type` 欄位中。

## 目錄更新頻率

完整目錄檔案每天更新兩次。當您透過 Fluz API 請求完整目錄時，您將會收到最近一次更新的快取版本。

## 優惠類型

商家可能會提供推薦、禮品卡優惠、連結卡片優惠以及專屬優惠。然而，目前僅有禮品卡與專屬優惠可透過 API 存取。

## 從您的儀表板擷取目錄

除了透過 API 存取目錄外，您也可以直接從 Fluz 儀表板下載：

1. 登入您的 Fluz 儀表板並前往「Stores」檢視。
2. 在該處，您可以選擇產生目錄匯出。
3. 匯出檔將以 CSV 檔案下載。

請留意，前述相同的更新頻率同樣適用於這些 CSV 檔案。

> 📘 促銷費率也會反映在目錄匯出中。若您在 Fluz 團隊進行促銷活動期間執行匯出，更新後的費率將會反映在您的匯出檔。