---
# System prepended metadata

title: URI-H-06 Favorite Company API
tags: [bizAdd]

---

# 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 有小至大

```json=
{ 
  "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 |



- 範例
```json=
 "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)

