QuoteCategories API
整理 quote_categories、quote_category_*、coupon / ibon 等分類側 API。
建議閱讀順序
| 目的 | 文件 |
|---|---|
| 看分類側正式機流量與下一支候選 | details/quote_categories/README.md |
流量結論
2026-06-23 查正式機 ip-10-5-2-242 目前保留的 /var/log/apache2/*access.log*：
| Endpoint | 筆數 | 判斷 |
|---|---|---|
GET /quote_categories/index/type:tree.json | 11984 | 高流量；已補 type:tree 專用 branch / PHPUnit；調查見 details/quote_categories/index_tree.md |
OPTIONS /quote_categories/index/type:tree.json | 9717 | 同上 |
POST /quote_categories/related.json | 7672 | 高流量；已補 QuoteCategories::related()、legacy path routing 與 PHPUnit |
OPTIONS /quote_categories/related.json | 3039 | 同上 |
GET /quote_categories/search.json?keyword=cleaning | 1 | 低流量，先不列優先 |
完整查詢指令與雜訊排除說明見 details/quote_categories/README.md。
| Endpoint | 方法 | 認證 | 來源 | 說明 | 新專案對應 | 狀態 | 備註 |
|---|---|---|---|---|---|---|---|
/quote_categories/addTravelPreference.json | 待確認 | 全域 API key | app/Plugin/Quotes/Controller/QuoteCategoriesController.php:288 | travel preference | 未找到 | 未找到 | 新專案沒有同名 endpoint method。 |
/quote_categories/get_category_map.json | GET | 全域 API key | app/Plugin/Quotes/Controller/QuoteCategoriesController.php:3482-3498 | category map | QuoteCategories::get_category_map() | 已補 action + routing + PHPUnit | 低流量，可能僅 Legacy Admin 偶發使用；已依 Legacy 保留無 filter／無 order 的 raw id => display_name map，待 Staging parity。詳見 details/quote_categories/get_category_map.md。 |
/quote_categories/saveSearchLog.json | 待確認 | 使用者 session | app/Plugin/Quotes/Controller/QuoteCategoriesController.php:3793 | search log | 未找到 | 未找到 | 新專案沒有同名 endpoint method。 |
/quote_category_wrappers/view.json | 待確認 | 全域 API key | app/Plugin/Quotes/Controller/QuoteCategoryWrappersController.php:397 | wrapper detail | 未找到 | 未找到 | 新專案沒有 QuoteCategoryWrappers endpoint。 |
/quote_category_wrappers/index.json | 待確認 | 全域 API key | app/Plugin/Quotes/Controller/QuoteCategoryWrappersController.php:423 | wrapper 清單 | 未找到 | 未找到 | 新專案沒有 QuoteCategoryWrappers endpoint。 |
/quote_ibon_groups/view.json | 待確認 | 全域 API key | app/Plugin/Quotes/Controller/QuoteIbonGroupsController.php:246 | ibon group | 未找到 | 未找到 | 新專案沒有 QuoteIbonGroups endpoint。 |
/quote_categories/view.json | 待確認 | 全域 API key | app/Plugin/Quotes/Controller/QuoteCategoriesController.php:2527 | category detail | QuoteCategories::view() | 同路徑已存在 | 新專案 Endpoint/V1/QuoteCategories.php 有同名 action。 |
/quote_categories/related.json | POST | 全域 API key | app/Plugin/Quotes/Controller/QuoteCategoriesController.php:2637 | related category | QuoteCategories::related() | 已補 action + routing + PHPUnit | 2026-06-22 正式 log：POST 200 有 7672 筆、OPTIONS 200 有 3039 筆；調查見 details/quote_categories/related.md。 |
/quote_categories/related_by_keywords.json | 待確認 | 全域 API key | app/Plugin/Quotes/Controller/QuoteCategoriesController.php:2909 | keyword related category | QuoteCategories::recommend_list() | 可能需改路徑 | 新專案沒有同名 method；可能由推薦清單相關 action 取代，需確認語意。 |
/quote_categories/index.json | GET | 全域 API key | app/Plugin/Quotes/Controller/QuoteCategoriesController.php:2973 | category 清單 / tree | QuoteCategories::index() | 已補 type:tree branch + PHPUnit | 2026-06-23 正式 log：GET /quote_categories/index/type:tree.json 200 有 11984 筆、OPTIONS 200 有 9717 筆；已補 legacy tree response parity，見 details/quote_categories/index_tree.md。 |
/quote_categories/search.json | 待確認 | 全域 API key | app/Plugin/Quotes/Controller/QuoteCategoriesController.php:3069 | category search | Search::index() | 可能需改路徑 | 2026-06-22 正式 log 僅見 1 筆 GET /quote_categories/search.json?keyword=cleaning 200；低優先。 |
/quote_categories/auto_complete.json | 待確認 | 全域 API key | app/Plugin/Quotes/Controller/QuoteCategoriesController.php:3111 | autocomplete | QuoteCategories::auto_complete() | 同路徑已存在 | 新專案 Endpoint/V1/QuoteCategories.php 有同名 action。 |
/quote_category_genres/view.json | 待確認 | 全域 API key | app/Plugin/Quotes/Controller/QuoteCategoryGenresController.php:450 | genre detail | Genre::index() / Genre::subgenre_index() | 可能需改路徑 | 新專案沒有 QuoteCategoryGenres::view()；前台 genre 頁在 Genre。 |
/quote_category_genres/index.json | 待確認 | 全域 API key | app/Plugin/Quotes/Controller/QuoteCategoryGenresController.php:459 | genre 清單 | QuoteCategoryGenres::index() | 同路徑已存在 | 新專案 Endpoint/V1/QuoteCategoryGenres.php 有同名 action。 |
/quote_category_groups/view.json | 待確認 | 全域 API key | app/Plugin/Quotes/Controller/QuoteCategoryGroupsController.php:507 | group detail | QuoteCategoryGroups::view() | 同路徑已存在 | 新專案 Endpoint/V1/QuoteCategoryGroups.php 有同名 action。 |
/quote_category_groups/index.json | 待確認 | 全域 API key | app/Plugin/Quotes/Controller/QuoteCategoryGroupsController.php:643 | group 清單 | QuoteCategoryGroups::index() | 同路徑已存在 | 新專案 Endpoint/V1/QuoteCategoryGroups.php 有同名 action。 |
/quote_coupons/index.json | 待確認 | 使用者 session | app/Plugin/Quotes/Controller/QuoteCouponsController.php:74 | coupon | QuoteCoupons::index() | 同路徑已存在 | 新專案 Endpoint/V1/QuoteCoupons.php 有同名 action。 |