# 取得會員刊登於 Marketplace 的商品內容
Custos-EnterpriseAPP-API-003
V1.1

Custos 企業會員進入 Marketplace 首頁後，點選 My listings 按鈕後，透過此 API 取得會員於該 Marketplace 所有維護的商品完整內容，並依據商品狀態分別顯示不同按鈕。

[toc]
## 作業啟動
1. 以傳入之使用者 token 取得使用者流水編號 #emp_data_id
2. 記錄 SystemLog：#emp_data_id|取得會員 Marketplace 商品內容|作業啟動

## API 作業啟動
1. 以 #emp_data_id 取得使用者所屬企業流水號 #corp_data_id、語系設定值 #language_setting
3. 以 #emp_data_id 和 #corp_data_id 取得該會員於 Marketplace 所有商品資訊
參考SQL:
*select * from corp_fm_item where corp_data_id = #corp_data_id and emp_data_id = #emp_data_id and item_status <> 'soldout'* --已轉售物品不再顯示

==取得之資料可透過傳入每頁筆數 data_number 以及要載入的頁碼 data_pages 兩項參數給 API，達到資料分頁；若不傳則撈取全部。==

## 作業結束
記錄 SystemLog: #emp_data_id|取得會員 Marketplace 商品內容|作業結束。

## 例外處理
若執行中有發生異常，將攔截到的 exception 訊息記錄 ErrorLog: [YYYYMMDDHHMMSS] EnterpriseAPP-API-003 發生異常：【#攔截到的 exception 訊息】

## 規格及範例
|API No|EnterpriseAPP-API-003|
|-|-|
|API Name|getEmpCorpFMItem|
|URL|${url}/APP/getData/getEmpCorpFMItem|
|Purpose|取得會員於 Marketplace 個人商品管理列表資訊|
|Description|透過 API 取得會員於 Marketplace 個人商品管理列表資訊
|Protocol|JSON over HTTP POST|
|Content-Type|application/json|

**Request**
|參數|型態|必填|長度|說明|
|-|-|:-:|:-:|-|
|token|String|Y||使用者驗證字串|
|category_id|String|N||欲取得之商品類別，不傳則撈全部；可傳多值，以逗號隔開|
|modify_oper|String|Y|10|記錄 APP 平台|

**Response**
|參數|型態|必回|說明|
|-|-|:-:|-|
|result|String|Y|API 執行結果，Y：成功，N：失敗|
|message|String|N|API 執行失敗的訊息說明|
|total_count|INT|Y|資料總筆數|
|data|Object|N|物件陣列，傳回資料內容；result = N 時，為空陣列([])|

**Request Sample**

var input = {
  "token": "...",
  "category_id": "2,4",
  "modify_oper": "Native Android"
}

**Response Sample**

{	
  "result": "Y",	//API 結果，result = Y 時才會有資料
  "message": "...",	//API 訊息，Ex："執行失敗, 原因：XXXXXXXXX"
  "total_count": 5,	//0 時顯示無商品刊登
  "data": [	
        {	
            "item_id": 1,	//物品代碼【corp_fm_item.item_id】
            "item_name": "霍曼寵物烘乾箱 Drybo Plus", 	//物品名稱【corp_fm_item.item_name】
            "item_dscr": "二種烘乾模式+二種貓窩模式、低分貝運轉、溫度精準控制、通風性能佳、6組安全感應器、獨家寵物擼擼窗", 	//物品描述【corp_fm_item.item_dscr】
            "category_id": 4     //租賃類別【corp_fm_item.category_id】
            "unit_amt": 10, 	//單位租金【corp_fm_item.unit_amt】
            "min_lease_days": 7, 	//最短租期【corp_fm_item.min_lease_days】
            "sale_amt": 1000,	//轉售售金【corp_fm_item.sale_amt】
            "item_status": "ontheshelf",	//物品狀態【corp_fm_item.item_status】；temp：暫存/待上架、ontheshelf：上架刊登中、leaseout：出租中、soldout：已售出
            "oth_contact": "",	//刊登員工其他聯絡資訊
            "emp_ext": "",	//員工分機
            "emp_email": "[e-mail]", //員工 email
            "address": "xxxx", //員工地址，預設帶入所屬企業 corp_member_main.corp_address，企業窗口登入時才出現此欄位
            "website": "http://123.com", //物品網站，預設帶入所屬企業 corp_member_main.corp_website，企業窗口登入時才出現此欄位
            "item_image": : "64wrrcasfr.jpg",	//物品照片【corp_fm_item.item_image】，分號隔開
            ...  
        }, 	
        {…}	
    ]
}