郵輪B2C P2 航程詳情(GetCruiseDetail)
API Content
說明
P1 搜尋結果點卡片進 P2 航程詳情頁時呼叫,一個產品一頁:產品內容、船艦資訊、可訂購出發日(含各艙型分類起價)、航線、須知、行程特色、艙房介紹卡片一次回齊;艙房介紹面板的房型內容另一支 GetCabinProfile。
- 方法:POST
- 路徑:
Cruise/Products/GetCruiseDetail
- 對應畫面:P1 搜尋結果卡片 → P2 航程詳情頁
使用重點:
- 一次回齊:出發區間、年份篩選、「共 N 個航次」、展開全部日期、出發日展開、相簿、郵輪資訊面板都用這一次的資料,不另呼叫;艙房介紹面板的房型內容呼叫 GetCabinProfile
- WEB、APP 回同一份內容:
Request_Mode只影響看得到哪些產品與價格,不裁欄位;文件寫「不顯示」只是說明目前畫面
- 出發區間預設帶 P1 搜尋的
Start_Date~End_Date,前端用它過濾Itinerary_List;年份 chips 依區間涵蓋的年份出現,只涵蓋一年就不顯示;「共 N 個航次」照目前選的年份算
- 沒經過 P1(分享連結、書籤):〔分享〕產生的網址帶出發區間起訖日,預設用網址上的區間;網址沒帶時,預設=
Itinerary_List第一筆~最後一筆的出發日(全部列出)。網址格式由前端定,本 API 不加參數
- 價格
Fare_Price(頁首、APP 底部列、每個出發日、各分類)都是每房、兩位大人、已含稅;只有船上小費由旅客在船上自付。雛形寫「(未稅)」、註腳寫「價格未含港務稅…」,字樣會改,等 UIUX
- 出發日展開:
Type_Price_List跟Cabin_Type_List同順序、一個分類一筆,名稱用Profile_Type_Name;Fare_Price是 null 顯示「⊘ 售完」;Is_PartialSoldOut是 true 顯示「部分艙房售完」。全部分類都沒貨的出發日不會出現
- 〔選擇〕:打 InitBookingLimit(帶該筆
Itinerary_Id)開「艙房 / 人數」燈箱,〔確認〕後帶該筆Itinerary_Id、Departure_Date與各房人數打 QueryCategory
- 艙房介紹面板:點艙房卡片或「艙房類型 ⓘ」(APP「查看艙房類型」)打開;頁籤、chips 與房型內容呼叫 GetCabinProfile,帶本回應的
Brand_Code、Ship_Code。點了才呼叫,進頁不用先抓
- 航線資訊:
Port_Name已組好(國家・港口、第一天「登船」、最後一天「離船」、海上日「海上航行」),照原樣顯示;時間是 HH:mm,null 顯示「–」
- 須知:
Notice_List照固定順序,前 4 種放「訂購須知」、後 4 種放「行前須知」;沒回的摺疊不顯示。內容都在Notice_Content,已組好,直接顯示
Ship_Info的欄位是 null 時該項顯示「-」;船齡Ship_Age由首航日即算,每天都是最新的
- 圖片:最外層
Image_List=產品的圖(封面第一)+行程特色各段的圖,不限 5 張;頁首主圖用Is_Cover為 true 那筆,APP 郵輪資訊面板用全部;APP 主圖下緣的 chips 是圖片分類,用Content_Type(中文直接顯示),點了切換該分類的圖;行程特色每段的Image_List最多 5 張
- 產品還在、但沒有可售出發日時照常回:
Itinerary_List、Port_Stop_List是 [],Fare_Price是 null
- 🟡 等 UIUX:〔選擇〕之後在哪選房數與人數、起價 ⓘ 的內容、出發區間下拉能選什麼;APP 賣點顯示哪一欄還沒定
- 「適用的優惠代碼」不在本 API
文件版本:v1.0(未交付)
規格調整
| 日期 | 版本 | 調整內容 |
|---|---|---|
| 2026/11/11 | v1.0(未交付) | 初版 |
Request Schema
Body
| 名稱 | 描述 | 屬性 | 範例 |
|---|---|---|---|
| Product_Id | 必填。P1 卡片的 Product_Id | Int | 101 |
| Request_Mode | 必填。呼叫端平台:WEB/APP(同 P1 搜尋) | String | WEB |
JSON 範例
{
"Product_Id": 101,
"Request_Mode": "WEB"
}Response Schema
回應主體
| 名稱 | 描述 | 屬性 | 範例 |
|---|---|---|---|
| Result_Info | 結果資訊;前端先看 Is_Success | Object | 參考 Result_Info |
| Result_Data | 成功時是本端點的資料;不是成功時只放該代碼要帶的資料(見「錯誤回應」),沒有就是 {} | Object | 參考 Result_Data |
Result_Info
| 名稱 | 描述 | 屬性 | 範例 |
|---|---|---|---|
| Is_Success | true=成功;false=看 Result_Code | Bool | true |
| Result_Code | 結果代碼(四碼數字);成功是空字串;其他見「錯誤回應」 | String | |
| Result_Message | 給客人看的訊息;成功是空字串 | String |
Result_Data
| 名稱 | 描述 | 屬性 | 範例 |
|---|---|---|---|
| Product_Id | 產品編號(同 Request) | Int | 101 |
| Product_Title | 產品標題:頁首標題、麵包屑、APP 產品名稱,照原樣顯示 | String | 迪士尼探險號|新加坡出發 3 晚海上假期 |
| Itinerary_Day | 晚數(例 3=3 晚):每個出發日的「3晚」 | Int | 3 |
| Brand_Name | 品牌名稱(副標) | String | 迪士尼郵輪 |
| Ship_Name | 船名(副標、郵輪資訊面板) | String | 迪士尼探險號 |
| Nav_Title | APP 導覽列文字,已組好(船名+晚數),直接顯示 | String | 迪士尼探險號 (3晚) |
| Brand_Code | 品牌代碼;畫面不顯示,開艙房介紹面板時帶去呼叫 GetCabinProfile | String | DCL |
| Ship_Code | 船艦代碼;畫面不顯示,開艙房介紹面板時帶去呼叫 GetCabinProfile | String | DA |
| Route_Description | 港口串接,例「新加坡 → 蘭卡威 → 新加坡」 | String | 新加坡 → 蘭卡威 → 新加坡 |
| Fare_Price | 起價:全部可售出發日的最低價,每房、兩位大人、已含稅、台幣整數;沒有可售出發日為 null | Int | 39800 |
| Image_List | 產品的圖(封面第一)+行程特色各段的圖;頁首主圖、相簿、APP 郵輪資訊面板都用它;筆數=〔查看全部照片 (N)〕的 N;沒有圖為 [] | List | 參考 Image_List |
| Feature_List | 頁首賣點,最多 3 條 | List | 參考 Feature_List |
| Ship_Info | 船艦規格:WEB 頁首灰框、行程特色列點;APP 郵輪資訊面板 | Object | 參考 Ship_Info |
| Itinerary_List | 可售出發日,照出發日由早到晚 | List | 參考 Itinerary_List |
| Cabin_Type_List | 艙型分類:艙房介紹卡片;面板的房型內容呼叫 GetCabinProfile | List | 參考 Cabin_Type_List |
| Port_Stop_List | 航線資訊,一天一筆 | List | 參考 Port_Stop_List |
| Notice_List | 訂購須知、行前須知的摺疊 | List | 參考 Notice_List |
| Ship_Content_List | 行程特色:一種型別一筆,段落在 Content_List | List | 參考 Ship_Content_List |
Image_List
| 名稱 | 描述 | 屬性 | 範例 |
|---|---|---|---|
| Image_Url | 圖片網址 | String | https://img.example.com/cruise/da-001.jpg |
| Alt_Text | 圖片替代文字 | String | 迪士尼探險號外觀 |
| Is_Cover | 是否為產品封面(頁首主圖);行程特色的圖一律 false。清單沒有 true 時前端用預設圖 | Bool | true |
| Content_Type | 圖片分類(APP 主圖下緣 chips),中文直接顯示;產品掛的圖為「船型介紹」,其他為所屬段落的型別 | String | 船型介紹 |
圖片物件
Cabin_Type_List.Cover_Image、Content_List.Image_List 都是這個形狀。
| 名稱 | 描述 | 屬性 | 範例 |
|---|---|---|---|
| Image_Url | 圖片網址 | String | https://img.example.com/cruise/da-001.jpg |
| Alt_Text | 圖片替代文字 | String | 迪士尼探險號外觀 |
Feature_List
| 名稱 | 描述 | 屬性 | 範例 |
|---|---|---|---|
| Feature_Title | 賣點標題(WEB「標題|說明」的前半);可為 null | String | 家庭用餐服務 |
| Feature_Desc | 賣點說明;可為 null | String | 家庭用餐區與兒童友善服務(Family Dining Hall) |
Ship_Info
| 名稱 | 描述 | 屬性 | 範例 |
|---|---|---|---|
| Home_Port_Name | 母港;可為 null | String | 新加坡 |
| Ship_Tonnage | 總噸位;可為 null | Int | 208000 |
| Guest_Capacity | 載客數;可為 null | Int | 6700 |
| Crew_Count | 船員數;可為 null | Int | 2500 |
| Maiden_Voyage_Date | 首航日 yyyy/MM/dd;可為 null | String | 2025/12/15 |
| Ship_Age | 船齡(今年減首航年,今年首航為 0);還沒首航或沒有首航日為 null | Int | 1 |
| Refurbished_Year | 翻新年份;沒翻新為 null(顯示「-」) | Int | null |
Itinerary_List
| 名稱 | 描述 | 屬性 | 範例 |
|---|---|---|---|
| Itinerary_Id | 出發日編號:打 QueryCategory 帶這個值 | Int | 5002 |
| Package_Id | 行程代碼,畫面不顯示。前端不用帶 | String | DA2610153SIN |
| Departure_Date | 出發日期 yyyy/MM/dd;星期前端算。打 QueryCategory 帶這個值 | String | 2026/10/15 |
| Return_Date | 回程日期 yyyy/MM/dd | String | 2026/10/18 |
| Fare_Price | 這個出發日的最低價(收合時「艙房最低價 $X 起」) | Int | 39800 |
| Is_PartialSoldOut | 有分類沒貨=true,顯示「部分艙房售完」 | Bool | true |
| Type_Price_List | 展開後各分類的價格,跟 Cabin_Type_List 同順序 | List | 參考 Type_Price_List |
Type_Price_List
| 名稱 | 描述 | 屬性 | 範例 |
|---|---|---|---|
| Profile_Type | 分類代碼 | String | suite |
| Profile_Type_Name | 分類名稱:出發日展開的分類名 | String | 禮賓級艙房 |
| Fare_Price | 這個分類的最低價「$X 起/房」;null=沒貨,顯示「⊘ 售完」 | Int | null |
Cabin_Type_List
| 名稱 | 描述 | 屬性 | 範例 |
|---|---|---|---|
| Profile_Type | 分類代碼 | String | interior |
| Profile_Type_Name | 分類名稱:卡片名稱 | String | 內艙房 |
| Profile_Count | 房型數「共 N 種房型」 | Int | 2 |
| Guest_Min | 入住人數下限:整組最小(艙房介紹卡片) | Int | 2 |
| Guest_Max | 入住人數上限:整組最大(艙房介紹卡片) | Int | 4 |
| Profile_Size_Min | 面積下限(平方公尺):整組最小(艙房介紹卡片);可為 null | Decimal | 16.1 |
| Profile_Size_Max | 面積上限(平方公尺):整組最大(艙房介紹卡片);可為 null | Decimal | 19.4 |
| Cover_Image | 卡片圖;可為 null | Object | 參考 圖片物件 |
Port_Stop_List
| 名稱 | 描述 | 屬性 | 範例 |
|---|---|---|---|
| Day_No | 第幾天(Day 1) | Int | 1 |
| Port_Name | 停靠港口,已組好的顯示文字 | String | 新加坡登船 |
| Arrival_Time | 抵達 HH:mm;null 顯示「–」 | String | null |
| Departure_Time | 啟航 HH:mm;null 顯示「–」 | String | 17:00 |
Notice_List
| 名稱 | 描述 | 屬性 | 範例 |
|---|---|---|---|
| Notice_Type | 摺疊標題,固定八種,照順序:購買資格、改票與取消政策、注意事項、契約條款(訂購須知);小費說明、護照簽證、出入境須知、其他注意事項(行前須知) | String | 購買資格 |
| Notice_Content | 摺疊內容(HTML),後端已組好,直接顯示;可為 null | String | <ul><li>所有遊客在航行當天必須年滿6個月。</li><li>未滿21歲的旅客必須與至少1位滿21歲以上的旅客同艙房。</li><li>懷孕滿24週的旅客(以登船日或航程期間計算)不可登船。</li></ul><ul><li>嬰兒和兒童必須計入總乘客人數。</li><li>所有旅客必須攜帶有效的政府簽發旅行證件,例如護照和所需簽證。</li><li>護照有效期須在郵輪行程結束日期後至少6個月。</li><li>未攜帶有效證件的旅客禁止登船。</li></ul> |
Ship_Content_List
| 名稱 | 描述 | 屬性 | 範例 |
|---|---|---|---|
| Content_Type | 分頁:船型介紹、郵輪特色、餐食特色、影片特色、自訂特色(照這個順序),一種型別一筆;只回有段落的型別 | String | 船型介紹 |
| Content_List | 這個型別的段落,已排好 | List | 參考 Content_List |
Content_List
| 名稱 | 描述 | 屬性 | 範例 |
|---|---|---|---|
| Content_Title | 段落小標 | String | 迪士尼探險號(Disney Adventure) |
| Content_Text | 段落內容(HTML);影片特色可為 null | String | <p>開啟一段充滿無限樂趣的全新探險之旅。迪士尼探險號 (Disney Adventure) 既是旅程,也是目的地。遊輪上滿載歡樂與閒適,精彩絕倫的娛樂演出,卓越非凡的賓客服務以及迪士尼特色主題餐飲美食等。</p><p>此遊輪從新加坡啟航,為賓客提供行程並擁有迪士尼遊輪的許多「首創」榮譽。在這片充滿想像、探索、夢幻與冒險的夢幻遊輪中,迪士尼、皮克斯和漫威將熱門故事注入其中,創造令人心馳神往的奇幻世界。</p> |
| Video_Url | 影片連結(影片特色一段一支,點了在原頁播放);其他型別為 null,自訂特色版型同餐食特色、沒有影片 | String | null |
| Image_List | 段落圖片,最多 5 張 | List | 參考 圖片物件 |
JSON 範例
{
"Result_Info": {
"Is_Success": true,
"Result_Code": "",
"Result_Message": ""
},
"Result_Data": {
"Product_Id": 101,
"Product_Title": "迪士尼探險號|新加坡出發 3 晚海上假期",
"Itinerary_Day": 3,
"Brand_Name": "迪士尼郵輪",
"Ship_Name": "迪士尼探險號",
"Nav_Title": "迪士尼探險號 (3晚)",
"Brand_Code": "DCL",
"Ship_Code": "DA",
"Route_Description": "新加坡 → 蘭卡威 → 新加坡",
"Fare_Price": 39800,
"Image_List": [
{
"Image_Url": "https://img.example.com/cruise/da-001.jpg",
"Alt_Text": "迪士尼探險號外觀",
"Is_Cover": true,
"Content_Type": "船型介紹"
},
{
"Image_Url": "https://img.example.com/cruise/da-002.jpg",
"Alt_Text": "迪士尼探險號側面外觀",
"Is_Cover": false,
"Content_Type": "船型介紹"
},
{
"Image_Url": "https://img.example.com/cruise/da-garden.jpg",
"Alt_Text": "Disney Imagination Garden",
"Is_Cover": false,
"Content_Type": "船型介紹"
},
{
"Image_Url": "https://img.example.com/cruise/da-show-01.jpg",
"Alt_Text": "舞台秀",
"Is_Cover": false,
"Content_Type": "郵輪特色"
},
{
"Image_Url": "https://img.example.com/cruise/da-toy-01.jpg",
"Alt_Text": "玩具主題遊樂區",
"Is_Cover": false,
"Content_Type": "郵輪特色"
},
{
"Image_Url": "https://img.example.com/cruise/da-avengers.jpg",
"Alt_Text": "Avengers Assemble",
"Is_Cover": false,
"Content_Type": "郵輪特色"
},
{
"Image_Url": "https://img.example.com/cruise/da-remember.jpg",
"Alt_Text": "Remember",
"Is_Cover": false,
"Content_Type": "郵輪特色"
},
{
"Image_Url": "https://img.example.com/cruise/da-moana.jpg",
"Alt_Text": "Moana: Call of the Sea",
"Is_Cover": false,
"Content_Type": "郵輪特色"
},
{
"Image_Url": "https://img.example.com/cruise/da-dining-01.jpg",
"Alt_Text": "餐廳內景 1",
"Is_Cover": false,
"Content_Type": "餐食特色"
},
{
"Image_Url": "https://img.example.com/cruise/da-dining-02.jpg",
"Alt_Text": "餐廳內景 2",
"Is_Cover": false,
"Content_Type": "餐食特色"
},
{
"Image_Url": "https://img.example.com/cruise/da-dining-03.jpg",
"Alt_Text": "餐廳內景 3",
"Is_Cover": false,
"Content_Type": "餐食特色"
},
{
"Image_Url": "https://img.example.com/cruise/da-dining-04.jpg",
"Alt_Text": "餐廳內景 4",
"Is_Cover": false,
"Content_Type": "餐食特色"
},
{
"Image_Url": "https://img.example.com/cruise/da-custom-01.jpg",
"Alt_Text": "自訂特色圖片",
"Is_Cover": false,
"Content_Type": "自訂特色"
}
],
"Feature_List": [
{
"Feature_Title": "家庭用餐服務",
"Feature_Desc": "家庭用餐區與兒童友善服務(Family Dining Hall)"
},
{
"Feature_Title": "熱門設施",
"Feature_Desc": "短行程也能完整使用的熱門設施(Toy Story Splash Zone)"
}
],
"Ship_Info": {
"Home_Port_Name": "新加坡",
"Ship_Tonnage": 208000,
"Guest_Capacity": 6700,
"Crew_Count": 2500,
"Maiden_Voyage_Date": "2025/12/15",
"Ship_Age": 1,
"Refurbished_Year": null
},
"Itinerary_List": [
{
"Itinerary_Id": 5001,
"Package_Id": "DA2610013SIN",
"Departure_Date": "2026/10/01",
"Return_Date": "2026/10/04",
"Fare_Price": 39800,
"Is_PartialSoldOut": false,
"Type_Price_List": [
{
"Profile_Type": "interior",
"Profile_Type_Name": "內艙房",
"Fare_Price": 39800
},
{
"Profile_Type": "oceanview",
"Profile_Type_Name": "海景艙房",
"Fare_Price": 49520
},
{
"Profile_Type": "balcony",
"Profile_Type_Name": "陽台艙房",
"Fare_Price": 69120
},
{
"Profile_Type": "suite",
"Profile_Type_Name": "禮賓級艙房",
"Fare_Price": 126000
}
]
},
{
"Itinerary_Id": 5002,
"Package_Id": "DA2610153SIN",
"Departure_Date": "2026/10/15",
"Return_Date": "2026/10/18",
"Fare_Price": 39800,
"Is_PartialSoldOut": true,
"Type_Price_List": [
{
"Profile_Type": "interior",
"Profile_Type_Name": "內艙房",
"Fare_Price": 39800
},
{
"Profile_Type": "oceanview",
"Profile_Type_Name": "海景艙房",
"Fare_Price": 49520
},
{
"Profile_Type": "balcony",
"Profile_Type_Name": "陽台艙房",
"Fare_Price": 69120
},
{
"Profile_Type": "suite",
"Profile_Type_Name": "禮賓級艙房",
"Fare_Price": null
}
]
}
],
"Cabin_Type_List": [
{
"Profile_Type": "interior",
"Profile_Type_Name": "內艙房",
"Profile_Count": 2,
"Guest_Min": 2,
"Guest_Max": 4,
"Profile_Size_Min": 16.1,
"Profile_Size_Max": 19.4,
"Cover_Image": {
"Image_Url": "https://img.example.com/cruise/da-in-01.jpg",
"Alt_Text": "內艙"
}
},
{
"Profile_Type": "oceanview",
"Profile_Type_Name": "海景艙房",
"Profile_Count": 2,
"Guest_Min": 4,
"Guest_Max": 4,
"Profile_Size_Min": 17.1,
"Profile_Size_Max": 19.4,
"Cover_Image": {
"Image_Url": "https://img.example.com/cruise/da-ov-01.jpg",
"Alt_Text": "海景艙"
}
},
{
"Profile_Type": "balcony",
"Profile_Type_Name": "陽台艙房",
"Profile_Count": 4,
"Guest_Min": 4,
"Guest_Max": 4,
"Profile_Size_Min": 19.4,
"Profile_Size_Max": 23.5,
"Cover_Image": {
"Image_Url": "https://img.example.com/cruise/da-ba-01.jpg",
"Alt_Text": "陽台艙"
}
},
{
"Profile_Type": "suite",
"Profile_Type_Name": "禮賓級艙房",
"Profile_Count": 12,
"Guest_Min": 5,
"Guest_Max": 6,
"Profile_Size_Min": 38.9,
"Profile_Size_Max": 228.6,
"Cover_Image": {
"Image_Url": "https://img.example.com/cruise/da-su-01.jpg",
"Alt_Text": "禮賓級艙房"
}
}
],
"Port_Stop_List": [
{
"Day_No": 1,
"Port_Name": "新加坡登船",
"Arrival_Time": null,
"Departure_Time": "17:00"
},
{
"Day_No": 2,
"Port_Name": "海上航行",
"Arrival_Time": null,
"Departure_Time": null
},
{
"Day_No": 3,
"Port_Name": "馬來西亞・蘭卡威",
"Arrival_Time": "11:00",
"Departure_Time": "21:15"
},
{
"Day_No": 4,
"Port_Name": "海上航行",
"Arrival_Time": null,
"Departure_Time": null
},
{
"Day_No": 5,
"Port_Name": "新加坡離船",
"Arrival_Time": "07:00",
"Departure_Time": null
}
],
"Notice_List": [
{
"Notice_Type": "購買資格",
"Notice_Content": "<ul><li>所有遊客在航行當天必須年滿6個月。</li><li>未滿21歲的旅客必須與至少1位滿21歲以上的旅客同艙房。</li><li>懷孕滿24週的旅客(以登船日或航程期間計算)不可登船。</li></ul><ul><li>嬰兒和兒童必須計入總乘客人數。</li><li>所有旅客必須攜帶有效的政府簽發旅行證件,例如護照和所需簽證。</li><li>護照有效期須在郵輪行程結束日期後至少6個月。</li><li>未攜帶有效證件的旅客禁止登船。</li></ul>"
},
{
"Notice_Type": "改票與取消政策",
"Notice_Content": "<p>當您報名付繳費用時即表示【迪士尼探險號訂購單】旅遊契約產生效力,旅客不得主張變更或取消本行程。若您因故取消,本公司將收取已實付的費用。</p><p>實際取消/變更規定以您所選方案顯示之條款為準</p>"
},
{
"Notice_Type": "注意事項",
"Notice_Content": "<p>注意事項內容示意。</p>"
},
{
"Notice_Type": "契約條款",
"Notice_Content": "<p>契約條款內容示意。</p>"
},
{
"Notice_Type": "小費說明",
"Notice_Content": "<p>船上小費由旅客於船上自付。</p>"
},
{
"Notice_Type": "護照簽證",
"Notice_Content": "<p>護照簽證內容示意。</p>"
},
{
"Notice_Type": "出入境須知",
"Notice_Content": "<p>出入境須知內容示意。</p>"
},
{
"Notice_Type": "其他注意事項",
"Notice_Content": "<p>其他注意事項內容示意。</p>"
}
],
"Ship_Content_List": [
{
"Content_Type": "船型介紹",
"Content_List": [
{
"Content_Title": "迪士尼探險號(Disney Adventure)",
"Content_Text": "<p>開啟一段充滿無限樂趣的全新探險之旅。迪士尼探險號 (Disney Adventure) 既是旅程,也是目的地。遊輪上滿載歡樂與閒適,精彩絕倫的娛樂演出,卓越非凡的賓客服務以及迪士尼特色主題餐飲美食等。</p><p>此遊輪從新加坡啟航,為賓客提供行程並擁有迪士尼遊輪的許多「首創」榮譽。在這片充滿想像、探索、夢幻與冒險的夢幻遊輪中,迪士尼、皮克斯和漫威將熱門故事注入其中,創造令人心馳神往的奇幻世界。</p>",
"Video_Url": null,
"Image_List": [
{
"Image_Url": "https://img.example.com/cruise/da-garden.jpg",
"Alt_Text": "Disney Imagination Garden"
}
]
}
]
},
{
"Content_Type": "郵輪特色",
"Content_List": [
{
"Content_Title": "七大主題區域",
"Content_Text": "<ol><li><b>Disney Imagination Garden</b>:擁有一座三層高的藝術城堡,內設先進劇場舞台,現場演出迪士尼經典故事,區內有兩家速食餐廳、一間酒吧。</li><li><b>Wayfinder Bay</b>:設有游泳池和寬敞的露天劇場座位,還可兼作獨特的表演場地,呈現精彩的現場表演及互動活動。</li><li><b>Toy Story Place</b>:擁有家庭泳池和互動戲水區等,日光甲板和觀景台提供充裕座位,全天播放迪士尼電影和問答遊戲,池畔有披薩、冰淇淋等速食,還有自助早餐和午餐可享用。</li><li><b>Disney Discovery Reef</b>:可以沉浸在《小美人魚》與《海底總動員》的故事,享受多樣美食體驗。</li><li><b>Town Square</b>:天花板裝飾著公主的彩色玻璃壁畫,華麗壯觀,全天上演百老匯音樂劇,並設有主題餐廳、酒吧、咖啡廳、沙龍和首家海上商店。</li><li><b>San Fransokyo Street</b>:擁有各種互動遊戲和電影院,體驗高科技產品,並可能遇見可愛的機器人杯麵!</li><li><b>Marvel Landing</b>:擁有全球最長「海上雲霄飛車」,長超過250公尺,探索史塔克科技風格,並在日光浴甲板和無邊泳池放鬆。</li></ol>",
"Video_Url": null,
"Image_List": [
{
"Image_Url": "https://img.example.com/cruise/da-show-01.jpg",
"Alt_Text": "舞台秀"
},
{
"Image_Url": "https://img.example.com/cruise/da-toy-01.jpg",
"Alt_Text": "玩具主題遊樂區"
}
]
},
{
"Content_Title": "特色娛樂",
"Content_Text": "<p>踏上這場海上冒險,盡情享受燦爛的音樂劇、熱鬧的甲板派對、迪士尼電影放映,以及與來自迪士尼、皮克斯和漫威的經典角色們難忘的見面會!</p><ol><li><b>Avengers Assemble</b>:這場精彩的舞台劇將在Disney Imagination Garden的花園舞台上上演,各種特技和特效讓人目不轉睛。將會看到鋼鐵人等漫威角色展現他們驚人的超能力。</li><li><b>Remember</b>:主角是皮克斯電影《瓦力》中的可愛機器人。這場全新的音樂劇會邀請《可可夜總會》、《小美人魚》等迪士尼和皮克斯的經典角色。</li><li><b>Moana: Call of the Sea</b>:這場《海洋奇緣》的音樂劇會在 Wayfinder Bay 的「海岸」上演,搭配音樂、舞蹈、木偶表演和水上特效,帶來視覺和聽覺上的震撼享受。</li><li><b>Disney Seas the Adventure</b>:可以和迪士尼和皮克斯角色一同踏上這場充滿歡樂的音樂之旅。</li><li><b>Baymax Super Exercise Expo</b>:可以和《大英雄天團》中的阿廣和杯麵一起,在Disney Imagination Garden的舞台上參加充滿活力的音樂運動課程。</li></ol>",
"Video_Url": null,
"Image_List": [
{
"Image_Url": "https://img.example.com/cruise/da-avengers.jpg",
"Alt_Text": "Avengers Assemble"
},
{
"Image_Url": "https://img.example.com/cruise/da-remember.jpg",
"Alt_Text": "Remember"
},
{
"Image_Url": "https://img.example.com/cruise/da-moana.jpg",
"Alt_Text": "Moana: Call of the Sea"
}
]
}
]
},
{
"Content_Type": "餐食特色",
"Content_List": [
{
"Content_Title": "特色娛樂餐廳(免費)",
"Content_Text": "<p>迪士尼探險號擁有6家主題餐廳,提供3種不同主題晚餐體驗。</p><p>※可體驗到3種不同主題的餐廳,實際以郵輪安排為主。</p><ul><li><b>Navigator's Club</b>:餐廳裝潢以復古航海元素為主,不僅能品嘗美食,還能與米奇等迪士尼好朋友一同欣賞音樂表演。</li><li><b>Hollywood Spotlight Club</b>:充滿好萊塢魅力的俱樂部裡,可以一邊享用美食,一邊欣賞最受歡迎的迪士尼角色-米奇、米妮等的現場表演。</li><li><b>Animator’s Palate</b>:餐廳內展示著《小美人魚》和《玩具總動員》等電影片段和道具,可以一邊品嚐美食,一邊看著自己的畫作在眼前活靈活現地呈現。</li><li><b>Animator’s Table</b>:擁有《阿拉丁》、《冰雪奇緣》等經典電影元素。可以一邊用餐,一邊裝飾著顏料罐、畫筆。</li><li><b>Enchanted Summer Restaurant</b>:餐廳以《魔髮奇緣》和《冰雪奇緣》為靈感,可以慶祝夏天的快樂時光。</li><li><b>Pixar Market Restaurant</b>:這間餐廳擁有《腦筋急轉彎》、《汽車總動員》等經典電影的元素。早午餐提供自助餐,晚餐則提供多樣化的美食。</li></ul>",
"Video_Url": null,
"Image_List": []
},
{
"Content_Title": "精緻餐廳(自費)",
"Content_Text": "<p>除了主題餐廳之外,還有高檔餐廳到速食服務,提供了很多的選擇來滿足各種食客的需求。</p><ol><li><b>Mike & Sulley's</b>:在這裡可以品嚐到亞洲四大經典美食:日式牛排、鐵板燒、Omakase(主廚推薦)和戶外壽司生魚片。餐廳設計受《怪獸電力公司》裡的日式餐廳啟發,結合傳統與創意,充滿特色。</li><li><b>Palo Trattoria(僅限10歲以上成人的餐廳)</b>:提供經典的北義大利美食,包括開胃菜、義大利麵、披薩、海鮮和烤牛排。餐廳設計靈感來自電影《盧卡》的夢幻天際,擁有星座、月光和天文主題的裝飾,營造出精緻的用餐氛圍。</li></ol>",
"Video_Url": null,
"Image_List": [
{
"Image_Url": "https://img.example.com/cruise/da-dining-01.jpg",
"Alt_Text": "餐廳內景 1"
},
{
"Image_Url": "https://img.example.com/cruise/da-dining-02.jpg",
"Alt_Text": "餐廳內景 2"
},
{
"Image_Url": "https://img.example.com/cruise/da-dining-03.jpg",
"Alt_Text": "餐廳內景 3"
},
{
"Image_Url": "https://img.example.com/cruise/da-dining-04.jpg",
"Alt_Text": "餐廳內景 4"
}
]
}
]
},
{
"Content_Type": "影片特色",
"Content_List": [
{
"Content_Title": "亞洲首艘!迪士尼探險號首航開箱",
"Content_Text": null,
"Video_Url": "https://www.youtube.com/watch?v=example1",
"Image_List": []
},
{
"Content_Title": "新加坡迪士尼探險號",
"Content_Text": null,
"Video_Url": "https://www.youtube.com/watch?v=example2",
"Image_List": []
}
]
},
{
"Content_Type": "自訂特色",
"Content_List": [
{
"Content_Title": "自訂特色標題",
"Content_Text": "<p>自訂特色內容,版型同餐食特色:小標、內容、圖片,沒有影片。</p>",
"Video_Url": null,
"Image_List": [
{
"Image_Url": "https://img.example.com/cruise/da-custom-01.jpg",
"Alt_Text": "自訂特色圖片"
}
]
}
]
}
]
}
}錯誤回應
200 的代碼在 Result_Info.Result_Code、訊息在 Result_Message;400、500 只回一句訊息,代碼在訊息開頭(格式「代碼|訊息」,例「4002|Start_Date 格式錯誤」)。訊息欄除了「重複訂位」與「出發日期已無法訂購,請重新選擇」已定,其他是暫定文字,UIUX 定稿後只改文字、不改代碼;N=第幾間。
| HTTP | Result_Code | 中文名稱 | 訊息(給客人看) | 情境 | 前端動作 |
|---|---|---|---|---|---|
| 200 | 3001 | 查無產品 | 此產品已下架 | 產品不存在、已下架,或本平台看不到 | 🟡 待定 |
| 400 | 4003 | 參數值不在範圍 | 不給客人看(訊息開頭是代碼) | Request_Mode 不在允許值 | 前端帶錯值,修正後重打 |
| 400 | 4002 | 參數格式錯誤 | 不給客人看(訊息開頭是代碼) | Product_Id 格式不符 | 前端帶錯值,修正後重打 |
| 500 | 9999 | 系統錯誤 | 9999|系統發生錯誤,請稍後再試 | 系統錯誤(未預期的例外) | 顯示友善錯誤訊息,可以重試 |
測試情境/單元測試(開發前規劃)
畫面呼叫
舊版畫面
新版畫面
P1 點卡片(WEB〔選擇〕、APP 點整張卡片;點出發日或〔更多〕則進 P2 並跳到可訂購日期)→ 呼叫本 API → P2 航程詳情頁;選出發日按〔選擇〕→ 打 InitBookingLimit → 開「艙房 / 人數」燈箱 → 按〔確認〕→ 打 QueryCategory,進 P3。雛形:UIUX 20260922 版 WEB P2-W01~W11、APP P2-A01~A14。
畫面欄位對照(WEB)
先看整頁(雛形 WEB P2-W01):每一塊標主要欄位,同一個比例從上標到下;灰色虛線=不在本 API。字小、擠的地方另拉細節圖。圖片可點開放大。

細節 1:頁首標題、賣點、船艦規格(P2-W01)

細節 2:相簿(P2-W02,點主圖或〔查看全部照片〕)

細節 3:出發日一筆(展開)(P2-W04)

細節 4:影片特色(P2-W08,行程特色的影片特色分頁)

WEB 不顯示:Package_Id、Nav_Title(APP 導覽列用)、Image_List[].Content_Type(APP 主圖圖片分類用)、Brand_Code、Ship_Code(呼叫 GetCabinProfile 用)。艙房介紹面板的欄位見 GetCabinProfile 文件。
畫面欄位對照(APP)
先看整頁(雛形 APP P2-A01);面板與展開另拉細節圖。圖片可點開放大。

細節 1:郵輪資訊面板(P2-A02,點「迪士尼郵輪|迪士尼探險號 ›」)

細節 2:出發日一筆(展開)(P2-A04)

細節 3:行程特色的影片(P2-A14,行程特色展開)

APP 雛形目前沒畫相簿,最外層 Image_List 用在主圖(含圖片分類 chips)與郵輪資訊面板;內容 WEB、APP 相同,APP 要做相簿可以直接用。兩個平台都不顯示:Brand_Code、Ship_Code(呼叫 GetCabinProfile 用)。艙房介紹面板的欄位見 GetCabinProfile 文件。