# I-STORY-01 Featured Store／Company Story列表頁
> [name=JasonWu]

###### tags: `成功故事`

## 網址
- https://{domain}/companyStory/search.html
- ex: https://idealez.taiwantrade.com/companyStory/search.html

## 原版程式
- com.hyweb.tt.cms.front.rest.CompanyStoryResource.java
- com.hyweb.tt.cms.front.service.pagedata.CompanyStoryListPageData.java

## 頁面功能說明 
- 透過 api 取得頁面所需資料
- 頁面可以輸入以下條件來查詢
- 查詢條件 keywords
- 查詢條件 catalogs > 下拉選單提供
- 查詢條件 firstCatId > 左側分類提供
- 點選左側分類，會將條件帶入並重新查詢
- 需要提供排序功能以及換頁功能
- 排序，預設使用 RELEVANCE, onShelveTime:decreasing
- page > 第幾頁，預設 1
- rows > 一頁幾筆，預設 20
- 點選列表的資料，進入詳目頁
- 現行程式有呼叫 product recommend 相關程式，但是頁面沒有顯示資料，需要確認此步驟與哪項需求有關；由於沒有顯示，所以這一段先不加入
- 參考現行 front 程式，分為三隻 api
- getCompanyStoryListCategory2Facet > 取得下拉分類條件
- getCompanyStoryList > 取得條列資料
- getCompanyStoryListFacet > 取得頁面左側後分類資料

## getCompanyStoryListCategory2Facet api

### 規格
- path : ${TT-API網址}/companystory/category/{did}/{storyId}
- method : GET

### API 邏輯
- 取得頁面 type 的下拉分類條件

### Input
Column | Type | Require | Desc
-----------|----------|---------|---------
domainId | number | Y | domain id > 確定 domain 與語系

### Output
- json 內容如下:

### 取值方式
- 透過 idol 取值

## getCompanyStoryList api

### 規格
- path : ${TT-API網址}/companystory/list/{did}
- method : GET
- query : ?keywords={keywords}&catalogs={catalogs}&firstCateId={firstCateId}&sidx={sidx}&rows={rows}&page={page}

### API 邏輯
- 取得 company story 查詢結果

### Input
Column | Type | Require | Desc
-----------|----------|---------|---------
did | number | Y | domain id > 確定 domain 與語系
keywords | string | Y | 查詢詞
catalogs | string | Y | 分類條件
firstCatId | string | Y | 後分類查詢條件
sidx | string | Y | 排序規則
rows | number | Y | 一頁幾筆
page | number | Y | 第幾頁

### Output
- json 內容如下:

### 取值方式
- 透過 idol 取值

## getCompanyStoryListFacet api

### 規格
- path : ${TT-API網址}/companystory/facet/{did}
- method : GET
- query : ?keywords={keywords}&catalogs={catalogs}&firstCateId={firstCateId}

### API 邏輯
- 取得 company story 查詢的後分類結果

### Input
Column | Type | Require | Desc
-----------|----------|---------|---------
did | number | Y | domain id > 確定 domain 與語系
keywords | string | Y | 查詢詞
catalogs | string | Y | 分類條件
firstCatId | string | Y | 後分類查詢條件

### Output
- json 內容如下:

### 取值方式
- 透過 idol 取值