API說明
| API位置 |
/new_ezding/orders/booking_start_trans |
| 需求描述 |
取得指定電影場次座位資訊 |
| 傳輸物件格式 |
json |
| 方法 |
POST |
| 頁面 |
A07訂票流程1920 _選位子 |
範例
curl -X POST \
-H " X-Ftcsys-key: {KEY}" \
-H " X- Accept-Language: {language}" \
-H "Content-Type: application/json" \
-d '{
"session_id": "4b2df95b82e94321aeb18acdc72a9b44",
"tickets": 2,
"coupon_num": "1745622043"
}
https://{endpoint}/new_ezding/orders/booking_start_trans?session_id=4b2df95b82e94321aeb18acdc72a9b44&tickets=1
回傳範例
< HTTP/1.1 200 OK
< Content-Type: application/json; charset=UTF-8
{
"result": {
"booking_info": {
"movie_title": {
"zh_tw": "電影中文名稱",
"en_us": "電影英文名稱"
},
"cinema_name": {
"zh_tw": "梅花影城",
"en_us": ""
},
"movie_version": "數位"
},
"transaction_id": "20018013560",
"sales_system": "3",
"seat_data": {
"output_string_length": "1527",
"scale_factor": "1",
"screen_height": "14",
"screen_width": "21",
"total_number_of_areas": "1",
"area_num": "1",
"area_category_code": "0000000001",
"y_start_pos": "0",
"x_start_pos": "0",
"is_selectable": "Y",
"area_desc": "Standard",
"area_alt_desc": " ",
"total_number_of_rows": "12",
"hall_id": null,
"seat_id": null,
"x_size": null,
"y_size": null,
"col_direction": null,
"seat_x": null,
"seat_y": null,
"seat_status": null,
"seats": [
[
{
"row_lable": "A",
"seat_lable": null,
"status": "1",
"grid_seat_row_id": "13",
"grid_seat_num": "3",
"pos_x": "18",
"pos_y": "2"
},
{
"row_lable": "A",
"seat_lable": null,
"status": "1",
"grid_seat_row_id": "13",
"grid_seat_num": "4",
"pos_x": "17",
"pos_y": "2"
}
],
[
{
"row_lable": "B",
"seat_lable": null,
"status": "0",
"grid_seat_row_id": "12",
"grid_seat_num": "1",
"pos_x": "20",
"pos_y": "3"
},
{
"row_lable": "B",
"seat_lable": null,
"status": "0",
"grid_seat_row_id": "12",
"grid_seat_num": "2",
"pos_x": "19",
"pos_y": "3"
}
]
],
"ori_seat_data": "1527|1|14|21|1|1|0000000001|0|0|Y|Standard| |12|13|A|03020I104020H106020F107020E108020D109020C10A020B10B020A10C020910D020810E020710F020610H020410I02031|12|B|01030K002030J003030I004030H006030F007030E008030D009030C00A030B00B030A00C030900D030800E030700F030600H030400I030300J03020|11|C|01040K002040J003040I004040H006040F007040E008040D009040C00A040B00B040A00C040900D040800E040700F040600H040400I040300J04020|10|D|01050K002050J003050I004050H006050F007050E008050D009050C00A050B00B050A00C050900D050800E050700F050600H050400I050300J05020|9|E|01060K002060J003060I004060H006060F007060E008060D009060C00A060B00B060A00C060900D060800E060700F060600H060400I060300J06020|8|F|01070K002070J003070I004070H006070F007070E008070D009070C00A070B00B070A00C070900D070800E070700F070600H070400I070300J07020|7|G|01080K002080J003080I004080H006080F007080E008080D009080C00A080B00B080A00C080900D080800E080700F080600H080400I080300J08020|5|H|01090K002090J003090I004090H006090F107090E108090D509090C50A090B00B090A00C090900D090800E090700F090600H090400I090300J09020|4|I|010A0K0020A0J0030A0I0040A0H0060A0F0070A0E0080A0D0090A0C00A0A0B00B0A0A00C0A0900D0A0800E0A0700F0A0600H0A0400I0A0300J0A020|3|J|010B0K0020B0J0030B0I0040B0H0060B0F0070B0E0080B0D0090B0C00A0B0B00B0B0A00C0B0900D0B0800E0B0700F0B0600H0B0410I0B0310J0B021|2|K|010C0K0020C0J0030C0I0040C0H0060C0F0070C0E0080C0D0090C0C00A0C0B00B0C0A00C0C0900D0C0800E0C0700F0C0600H0C0410I0C0310J0C021|1|L|010D0K0020D0J0030D0I0040D0H0050D0G0060D0F0070D0E0080D0D0090D0C00A0D0B00B0D0A00C0D0900D0D0800E0D0700F0D0600G0D0500H0D0400I0D0300J0D020|0000000001|0|"
},
"seat_table": {
"seat": "empty",
"tag": "5-23;10-23-1"
}
},
"code": "200",
"status": "success"
}
接收json參數
| 參數 |
名稱 |
範例 |
必填 |
備註 |
| session_id |
場次ID |
4b2df95b82e94321aeb18acdc72a9b44 |
Y |
|
| tickets |
訂票張數 |
1 |
Y |
最少1張，最多6張 |
| coupon_num |
優惠券序號 |
1745622043 |
N |
優惠序號 ( 多個Coupon請以 , 分隔 ex: 1745622043,1745622044 ), 若無請帶空字串 |
回傳json的參數
| 參數 |
名稱 |
範例 |
必填 |
備註 |
| booking_info |
訂票資訊 |
|
Y |
|
| movie_title |
電影名稱資料 |
|
Y |
|
| zh_tw |
電影中文名稱 |
擺渡人 |
Y |
|
| en_us |
電影英文名稱 |
Baido |
Y |
|
| cinema_name |
影城名稱資料 |
|
Y |
|
| zh_tw |
影城中文名稱 |
美麗華大直 |
Y |
|
| en_us |
影城英文名稱 |
|
N |
|
| movie_version |
電影版本 |
數位 |
Y |
|
| transaction_id |
影城交易代碼ID |
12341234 |
Y |
|
| sale_system |
影城銷售系統 |
2 |
Y |
2:威秀(vista1代)、3:美麗華、4 or 6:喜德碼、5:樂聲、7:新光(vista2代)、8:粵科 |
| seat_data |
座位資料 |
|
Y |
|
| output_string_length |
回傳字串長度 |
1695 |
Y |
|
| scale_factor |
|
1 |
Y |
|
| screen_height |
座位圖的長度(縱軸總共有幾格) |
14 |
Y |
|
| screen_width |
座位圖的長度(橫軸總共有幾格) |
28 |
Y |
|
| total_number_of_areas |
|
1 |
Y |
sales_system=2or3 |
| area_num |
|
1 |
Y |
|
| area_category_code |
座位類別代碼 |
0000000001 |
Y |
|
| y_start_pos |
縱軸座位起始 |
0 |
Y |
|
| x_start_pos |
橫軸座位起始 |
0 |
Y |
|
| is_selectable |
是否已選取 |
Y |
Y |
|
| area_desc |
座位描述 |
Standard |
Y |
|
| area_alt_desc |
座位補充說明 |
|
N |
|
| total_number_of_rows |
總排數 |
12 |
Y |
|
| seats |
各別座位資料 |
|
Y |
|
| grid_seat_num |
|
4 |
Y |
皆為固定長度為2的字元編碼，用固定長度編碼來表示數字(digit number) |
| pos_y |
座位橫軸座標 |
2 |
Y |
皆為固定長度為2的字元編碼，用固定長度編碼來表示數字(digit number) |
| pos_x |
座位縱軸座標 |
24 |
Y |
皆為固定長度為2的字元編碼，用固定長度編碼來表示數字(digit number) |
| status |
座位狀態 |
1 |
Y |
0:可供客戶選擇，1:已被預訂，3:特殊座位(例如包廂，目前EZ訂未使用，會變成空格)，5:此筆交易的系統自動選位，6:戲院保留位，7:已售出 |
| row_lable |
排數 |
A |
Y |
|
| grid_seat_row_id |
|
13 |
Y |
|
| ori_seat_data |
原始座位資料字串 |
|
N |
|
| seat_table |
前端用的座位二維陣列資料 |
|
Y |
|
| seat |
座位狀態 |
empty |
Y |
empty可預訂、appointment：已售出、selected：系統預選位、TRANSPARENT：空白位(走道或無用位) |
| tag |
座位資訊 |
5-23 |
Y |
粵科：i - j ; seatId |
|
|
|
|
新光：i - j ; pos_x - pos_y - grid_seat_num |
|
|
|
|
非新光 ：i - j ; grid_seat_row_id - grid_seat_num |
|
|
|
|
狀態為TRANSPARENT時,tag為none |
不同影城銷售系統座位狀態代碼mapping
| 影城銷售系 |
回傳status |
ezdingapi status |
狀態說明 |
| 威秀(2) |
0 |
0 |
可供客戶選擇 |
|
1 |
1 |
已被預訂 |
|
3 |
3 |
特殊座位(例如包廂，目前EZ訂未使用，會變成空格) |
|
5 |
5 |
此筆交易的系統自動選位 |
|
6 |
6 |
戲院保留位 |
|
7 |
7 |
已售出 |
|
9 |
9 |
走道 |
| 新光(7) |
0 |
0 |
空座 |
|
1 |
1 |
已售 |
|
2 |
2 |
保留座位(影院保留座) |
|
3 |
3 |
特殊座位(轮椅座) |
|
5 |
5 |
坏座(座位损坏，无法出售) |
|
7 |
7 |
特殊保留座(可理解为无法销售的座位) |
|
|
55 |
系統自動選位 |
| 樂聲(5) |
OK |
5 |
系統預選位 |
|
NO |
1 |
非供EZ訂使用空位或已被訂走的位子 |
|
|
0 |
可供ez訂訂購的座位 |
|
|
-1 |
走道 |
| 喜德碼(4or6) |
同威秀(2) |
|
|
| 美麗華(3) |
同威秀(2) |
|
|
| 凱擘(8) |
|
0 |
可供ez定訂購的座位 |
|
|
5 |
系統預選位 |
|
|
1 |
已被預訂 |