APP · 找服務搜尋 · 3 ENDPOINTS · v0.2（2026-10-19）

找服務搜尋 API 文件

找服務搜尋頁追加兩個功能：打字時彈出建議、詳細搜尋結果頁（排序、置頂、分頁）。共三支：熱門服務清單、搜尋（建議與結果頁共用）、後台紀錄。欄位由前端依 PM 規劃與靜態切版推導，尚未與後端確認；路徑與欄位名稱都可以改，前端只要改資料層。

共用層 Response

以下各端點文件均省略此共用外層，範例僅呈現 Data 內容（右上開關可切換成完整回應）。一律 POST、application/json；訪客 token 也要能呼叫。欄位一律大駝峰，陣列欄位命名為 XxxList。查無資料是成功，回空陣列，不要回 null。選填欄位沒有值時：字串回 ""、陣列回 []，不要回 null、不要省略欄位。上下架與權限由後端過濾：未上架的服務不回，前端不判斷。


      

        

          
FS2 Sort（結果頁排序）

          

            relevance 依關聯度（預設）
            hot 依點擊熱度
            newest 依上架時間
          

        

        

          
FS3 Action（使用者做了什麼）

          

            suggest 點打字建議
            search 按搜尋鍵／查看全部／點最近搜尋
            result 點結果頁卡片
            hot 點熱門服務推薦
          

        

        

          
Data.ErrorCode（失敗時，名稱為建議值）

          

            KEYWORD_INVALID
          

        

      

    

  


  

    
畫面總覽

    
假資料、手機寬 390 的 prototype 畫面；點圖放大。每張圖下方標示用到哪一支 API。

    

  


  


  

    
版本紀錄

    

      
版本日期內容

      
v0.22026-10-19確認：FS2 新開一支（舊的 FindService 不動）；置頂用 IsTop 放在同一個 ServiceList；關聯度與點擊熱度演算法由後端決定；FS3 的 search 統計關鍵字、suggest／result／hot 算點擊熱度；關鍵字 50 字 OK。打字建議改成一打字就出選單，查無時只顯示「搜尋「X」」

      
v0.12026-10-19初版草案：FS1 熱門服務清單（取代 ALL-1-1-10 Type S）、FS2 搜尋（打字建議與詳細搜尋結果頁共用，Sort 三種、IsTop 置頂、TotalNum 總筆數、分頁）、FS3 後台紀錄（suggest／search／result／hot 四種）

    

  


  

    
待後端確認

    
    
  
    
  
    沒有符合的端點，換個關鍵字試試。