---
# System prepended metadata

title: API007

---

# API007
	
    頁 次 : 1 / 9
文件編號：
GOG-EnterpriseAPP-API-007	文件名稱：企業跳蚤市場許願池增修刪儲存	機密等級：一般




 企業跳蚤市場


企業跳蚤市場許願池增修刪儲存


需求規格書








| 哈哈 1 | Column 2 | Column 3 |
| -------- | -------- | -------- |
| Text     | Text     | Text     |









文件編號：	GoG-EnterpriseAPP-API-007
版	次：	V1.2
製作日期：	2022.12.28
 

	頁 次 : 2 / 9
文件編號：
GOG-EnterpriseAPP-API-007	文件名稱：企業跳蚤市場許願池增修刪儲存	機密等級：一般

 修  訂  履 歷

版次	發行日期	作者	修	訂	內	容	備	註
V1.0	2022.05.21	林紋慈	初版發行	
V1.1	2022.05.30	林紋慈	許願池新增按讚功能	
V1.2	2022.07.29	劉鎧禎	新增許願池取消按讚功能	
V1.3	2022.12.28	劉鎧禎	調整版本號規則	因應企業版APP
 

	頁 次 : 3 / 9
文件編號：
GOG-EnterpriseAPP-API-007	文件名稱：企業跳蚤市場許願池增修刪儲存	機密等級：一般

 目	錄
1.	需求描述	5
1-1.	需求說明	5
1-2.	作業流程圖	5
2.	作業執行步驟	5
2-1.	作業執行步驟彙整	5
2-2.	API 執行步驟項目詳細說明	6
2-3.	例外處理	7
2-4.	API 規格及範例	8
 

	頁 次 : 4 / 9
文件編號：
GOG-EnterpriseAPP-API-007	文件名稱：企業跳蚤市場許願池增修刪儲存	機密等級：一般
 圖表目錄

圖-1.	API-007 企業跳蚤市場許願池流程圖	5
圖-2.	API-007 作業流程彙整	6
 

	頁 次 : 5 / 9
文件編號：
GOG-EnterpriseAPP-API-007	文件名稱：企業跳蚤市場許願池增修刪儲存	機密等級：一般
1.	需求描述
1-1.	需求說明
GoG  企業會員進入跳蚤市場->許願池功能後，可點選自己許願的資料進行修改/刪除， 或點選新增按鈕新增許願內容，完成動作選按確認按鈕後透過此API 將該筆許願內容進行增刪修儲存至資料庫。

1-2.	作業流程圖

圖-1. API-007 企業跳蚤市場許願池流程圖

2.	作業執行步驟
2-1.	作業執行步驟彙整
 

	頁 次 : 6 / 9
文件編號：
GOG-EnterpriseAPP-API-007	文件名稱：企業跳蚤市場許願池增修刪儲存	機密等級：一般


圖-2. API-007 作業流程彙整

2-2.	API 執行步驟項目詳細說明
2-2-1.	企業跳蚤市場許願池資料增刪修儲存作業啟動

2-2-1-1.	記錄SystemLog
[YYYYMMDDHHMMSS] EnterpriseAPP-API-007 步驟：企業跳蚤市場許願池資料增刪修儲存作業啟動
2-2-1-2.	API 作業啟動:
1.	傳入【#增刪修異動代碼】和許願欄位資料。
2-2-2.	許願池資料增刪修儲存作業

2-2-2-1.	記錄SystemLog:
[YYYYMMDDHHMMSS] EnterpriseAPP-API-007 步驟：進行許願池資料增刪修儲存作業，異動代碼：【＃異動代碼】、資料序號：【＃資料序號】
2-2-2-2.	資料增刪修儲存至資料庫: 新增：
以傳入資料欄位至【企業跳蚤市場許願池(corp_fm_wish)】將資料新增進去。
 

	頁 次 : 7 / 9
文件編號：
GOG-EnterpriseAPP-API-007	文件名稱：企業跳蚤市場許願池增修刪儲存	機密等級：一般

修改/刪除:
以傳入之【#資料序號】至【企業跳蚤市場許願池(corp_fm_wish)】進行資料刪除修改。
按讚:
以傳入之【#資料序號】至【企業跳蚤市場許願池(corp_fm_wish)】將 wish_like_cnt
進行加 1 後更新該欄位。
同時將該筆員工按讚資料(like_emp_id、like_emp_phone)新增一筆紀錄至許願池按讚明細檔<corp_fm_wish_like>。
*自己無法對自己許願物品按讚取消按讚：
以傳入之【#資料序號】至【企業跳蚤市場許願池(corp_fm_wish)】將 wish_like_cnt
進行減 1 後更新該欄位。
同時將該筆員工按讚資料(like_emp_id、like_emp_phone)自明細檔
<corp_fm_wish_like>移除。成功後記錄SystemLog
2-2-2-3.	成功後紀錄SystemLog:
紀錄SystemLog:
[YYYYMMDDHHMMSS] EnterpriseAPP-API-007 步驟：進行許願池資料增刪修儲存作業，異動代碼：【＃異動代碼】、資料序號：【＃資料序號】，作業成功。


2-2-3.	結束

2-2-3-1.	記錄SystemLog:
[YYYYMMDDHHMMSS] EnterpriseAPP-API-007 步驟：許願池資料增刪修儲存作業結束
2-2-3-2.	結束流程。


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

	頁 次 : 8 / 9
文件編號：
GOG-EnterpriseAPP-API-007	文件名稱：企業跳蚤市場許願池增修刪儲存	機密等級：一般

2-4.	API 規格及範例

API No	EnterpriseAPP-API-007
API Name	setCorpFMWish
URL	${url}/APP/getData/setCorpFMWish
Purpose	許願池資料增刪修儲存作業
Description	透過API 進行許願池資料增刪修儲存作業
Protocol	JSON over HTTP POST
Content-Type	Content-Type=application/json
底層介接
Request	JSON Object
參數	型態	必填	長度	說明
modify_type	String	Y	1	C:新增 U:修改 D:刪除 P:
按讚 N:取消按讚
seq_id	Int			新增時為空白
修改刪除時為必填
wish_item_nm	String			刪除時可空白
新增修改時為必填
corp_id	String	Y		從APP 儲存的取出
emp_id	String	Y		從APP 儲存的取出
emp_phone	String	Y		從APP 儲存的取出
emp_ext	String	Y		從APP 儲存的取出

wish_lease_type	String			刪除時可空白
新增修改時為必填
按讚時可空白

wish_unit_amt	
Int			刪除、按讚時可空白新增修改時且
wish_lease_type=’1’為必填

wish_period_unit	
String			刪除、按讚時可空白新增修改時為且
wish_lease_type=’1’為必填

wish_sale_amt	
Int			刪除、按讚時可空白新增修改時且
wish_lease_type=’2’為必填
wish_title	String	Y		刪除、按讚時可空白
新增修改時為必填
wish_content	String	Y		刪除、按讚時可空白
新增修改時為必填
Response	JSON Object
參數	型態	必回		說明
result	String	Y		API 執行結果，Y:成功, N:
 

	頁 次 : 9 / 9
文件編號：
GOG-EnterpriseAPP-API-007	文件名稱：企業跳蚤市場許願池增修刪儲存	機密等級：一般


				失敗
message	String	N		API 執行失敗的訊息說明
Request Sample （Json）
資料格式	說明
var input = { "modify_type":"C",
"seq_id":"", "corp_id":"gogreen", "emp_id":"00002", "emp_phone":"0988xxxxxx", "wish_lease_type":"1,2", "wish_unit_amt":"10", "wish_period_unit":"D", "wish_sale_amt":"100", "wish_title":"許願【睡袋】",
"wish_content":"請問有人有【睡袋】可【出租/轉售】嗎? 希望租金為
【10元/天】，希望售金為【100】，請與分機ｘｘｘｘ聯絡，或刊登至跳 蚤市場。謝謝！"
}	




Json Request Sample
Response Sample
資料格式	說明
{	
"result": "Y",	API 結果
Result=Y 時才會有資料

"message": ""	API 訊息
Ex: "執行失敗, 原因:
XXXXXXXXX"
}	

