## 基本查詢 ### 簡單過濾 - 您可以直接在查詢字符串中添加字段來過濾數據。 - 示例：`GET /api/users?name=John&status=active` ### 分頁 - 使用 `page` 來指定頁碼。 - 使用 `per_page` 來指定每頁顯示的記錄數。 - 示例：`GET /api/users?page=2&per_page=15` ## 進階查詢 ### 搜索模式 - `search_mode` 可以是 `and` 或 `or`，用於指定多個過濾條件的邏輯關系。 - 示例：`GET /api/users?name=John&status=active&search_mode=or` ### 搜索字段和條件 - 使用 `search_fields` 來指定搜索字段和相應的比較條件。 - 條件可以是 `=`, `like`, `in`, `date`, `between` 等。 - 每個字段的條件用冒號分隔，不同字段間用分號分隔。 - 示例：`GET /api/users?search_fields=name:like;status:in&name=Jo&status=active,suspended` ### 排序 - 使用 `order_by` 來指定排序字段。 - 使用 `order_direction` 來指定排序方向，可以是 `asc` 或 `desc`。 - 支持多字段排序，不同字段用分號分隔。 - 示例：`GET /api/users?order_by=name;created_at&order_direction=asc;desc` ## 注意事項 - 確保您的請求與後端 API 規範相匹配。 - 在實際應用中，參數名稱和功能可能會根據後端的實現有所不同。 - 請與後端開發者確認具體的 API 細節和可用的參數。