# URI-H-06 Favorite Company API

###### tags: `bizAdd`
> [name=RoyHuang]

------------------------------------------------------------------------
## API 清單
No | API | Desc | 執行順序 | 執行條件
:-:|----------|------------------|:-------:|----------
1 | URI-H-06 | Prepare biz data | 1 | page init

------------------------------------------------------------------------
## Prepare biz data
- Favorite Company 商機所需顯示的資料

### Path
- {TT API 網址}/business/prepare/fav-company
- method : POST
- body : application/json;charset=UTF-8
- query : None

### Input JSON Path
欄位名稱 | 欄位說明 | 資料型態 | 是否必填 | 備註
---------|--------|----------|:--------:|-----
favCompanyInfos | 公司id和語系id的資料集合 | string | Y | 公司id + dash + 語系id，多組用逗號區隔

- EX: "65-41,147927-42"

### Output JSON Path
- 以公司切分群族
- 排序
- 1) 公司排序依公司id 有小至大

{ 
  "code"      : <number> , // 代碼，0：ok、 < 0: error 使用
  "errorMsg"  : <string> , // 錯誤訊息
  "data" : [
      {
          "company_id"         : <number>, // 公司id
          "language_id"        : <number>, // 語系id
          "contact_name"       : <string>, // 公司聯絡人名稱
          "company_name "      : <string>, // 公司名稱
      }, 
      ...{}
  ]
}

欄位名稱 | 欄位說明 | 資料型態 | 是否空值 | 備註
---------|--------|----------|:--------:|-----
code | 代碼 | number | N | 0：ok、 < 0: error 使用
errorMsg | 錯誤訊息 | string | N | 代碼 < 0 時，會紀錄錯誤訊息
data | 資料集合 | Array[Object] | N | [公司清單(Object)](#公司清單)

#### 公司清單
欄位名稱 | 欄位說明 | 資料型態 | 是否空值 | 備註
---------|--------|----------|:--------:|-----
companyId | 公司id | number | N | 整數，long type<br>EX: 2147483647
language_id | 語系id | number | N | 整數，int type
contact_name | 公司聯絡人名稱 | number | N |
company_name | 公司名稱 | number | N |

- 範例

 "code"      : 0
  "errorMsg"  : ""
  "data" : [
      {
          "companyId"         : 65,
          "languageId"        : 42,
          "contactName"       : "測試看看",
          "companyName"       : "TAIWAN EXTERNAL TRADE DEVELOPMENT COUNCIL",
      },
      {
          "companyId"         : 147927
          "languageId"        : 42
          "contactName"       : "李***"
          "companyName"       : "HYWEB TECHNOLOGY CO., LTD."
      }, 
  ]
}

### SQL
[參考](https://hackmd.io/kQegnS_oTGCx5MN1LOVDFQ?view#Favorite-company-Prepare-template-data)