owned this note
owned this note
Published
Linked with GitHub
# URI-B-02 活動詳細頁 API
###### tags: `URI-B` `API規格`
> [name=Tony Fan, Kenshi Chen]
## 內容
### 網址
- https://tw.taiwantrade.com/event/%E8%8B%B1%E6%96%87%E5%A5%91%E7%B4%84%E4%B9%8B%E6%92%B0%E6%93%AC-%E5%AF%A9%E9%96%B1%E5%8F%8A%E8%AB%87%E5%88%A4%E8%A6%81%E8%A8%A3-2292025.html
### 程式
- com.hyweb.tt.cms.front.rest.EventResource.java
- com/hyweb/tt/cms/cm/layoutdefine/consumer/EventCpConsumer.java
### Input JSON Path
#### 規格
- path : `${TT-API網址}/events/detail/{did}/{id}`
- method : GET
- query : 無
- body : 無
#### 輸入參數說明
- did: 網別代碼
- id : 活動id
#### 範例
```=json
https://tt-api.taiwantrade.com/events/detail/801/2292025
```
* 參考 [URI-B-02 測試案例](https://docs.google.com/spreadsheets/d/1DFZ1-6PyIb4fam4qhMeykC_iHtLns8VSe_BKYNZqX7c/edit#gid=1093005017)
### Output JSON Path
#### 規格
```=json
{
"code": 0,
"errorMsg": null,
"data": {
"eventId": 1896171,
"title": "2022年澳洲國際汽車售後服務零配件展",
"description": "2022年澳洲國際汽車售後服務零配件展\n本展為澳洲規模最大之汽車零配件展,於每兩年在澳洲墨爾本展覽中心展出,為澳洲當地最具指標性的汽車售後服務展覽,上屆(2019年)有來自超過30國1萬名專業買主到訪,參展商總計13國311家,展出項目包含汽車引擎、懸吊、煞車、輪胎、動力、內裝、修護、改裝品等。匯集當地汽車售後服務製造商、進出口商和服務商,也是大洋洲和全球汽車零配件供應鏈業者的重要交流盛事,該展也是我國業者布局大洋洲的重要展覽曝光平台。\n澳洲汽車零配件內銷市場規模超過80億澳元,國內現有超過50種汽車品牌和350多種車型,總量超過1,700萬輛,因此對汽車維修與改裝需求旺盛,歡迎有興趣進軍澳洲汽車零配件市場之我商報名參加,名額有限,報名從速!\n報名網址:https://form.taiwantrade.com/event/AAAE2022",
"eventBeginDate": 1649260800000,
"eventEndDate": 1649260800000,
"location": null,
"eventTypeId": 1090,
"eventType": "國外展覽",
"websiteUrl": "https://events.taiwantrade.com/page/EBS/AAAE2022",
"organizers": "AAAA",
"contactPeople": [
{
"name": "彭皓治",
"tel": "2725-5200 分機 1567",
"email": "alexpen@taitra.org.tw"
}
]
}
}
```
#### 輸出參數說明
活動輸出欄位
| 欄位名稱 | 欄位說明 | 型態 | 是否可為空值 |
| -------- | -------- | -------- | -------- |
| code | 代碼 | int | 0表示ok |
| errorMsg | 錯誤訊息 | String | |
| eventId | 活動 ID | int | N |
| title | 活動名稱 | String | N,<br>DB限制:varchar 300 |
| description | 活動簡介/內容 | String |DB限制:clob |
| location | 活動地點 | String | |
| eventBeginDate | 活動起始日 | int(日期) | |
| eventEndDate | 活動日結束 | int(日期) |
| websiteUrl | 活動相關網頁(URL) | String | |
| ~~eventTypeId~~ | ~~活動類型代碼~~ |~~int~~ | |
| eventType | 活動類型名稱(項目類型)|String | |
| organizers | 主辦單位名稱 | String | |
|contactPeople | 連絡人清單 | [`連絡人欄位(Array Object)`](#連絡人欄位) ||
##### 連絡人欄位
| 欄位名稱 | 欄位說明 | 型態 | 是否可為空值 |
| -------- | -------- | -------- |-------- |
| name | 聯絡人姓名 | String | |
| email | 聯絡人Email | String | |
| tel | 聯絡人電話號碼 | String | |
* 連絡人欄位對應說明 : 連絡人欄位取自 ARTICLE_EVENT Table中
* main_contractor 聯絡人姓名1
* main_contractor_email 聯絡人Email1
* main_contractor_tel 聯絡人電話號碼1
* secondary_contractor 聯絡人姓名2
* secondary_contractor_email 聯絡人Email2
* secondary_contractor_tel 聯絡人電話號碼2
#### SQL
```=sql
SELECT a.aid, m.title, m.description, m.event_begin_time, m.event_end_time,
a.main_contractor, a.main_contractor_email, a.secondary_contractor, a.secondary_contractor_email,
a.main_contractor_tel, secondary_contractor_tel, a.location, a.url,
c.code_name AS event_type, event_type AS event_type_id
FROM ARTICLE_EVENT a
JOIN MULTI_ARTICLE_EVENT m ON a.aid = m.aid
JOIN DOMAIN d ON d.did = 801 --DOAMIN ID
LEFT JOIN CODE_META c ON c.cid = a.event_type
WHERE a.aid = 1896171 --活動ID
AND m.language_id = d.language_id;
```