> ## 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 团队进行促销期间运行任何导出，这些更新后的费率将会体现在您的导出文件中。