---
# System prepended metadata

title: I-STORY-01 Featured Store／Company Story列表頁
tags: [成功故事]

---

# 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

## 頁面功能說明 ![](https://i.imgur.com/8sydzgc.jpg)
- 透過 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 內容如下:
```=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 內容如下:
```=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 內容如下:
```=json
```

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