API說明
API位置 |
/new_ez_order/ez_trans/update_ez_cinema_trans |
需求描述 |
更新ez_cinema_trans |
傳輸物件格式 |
json |
方法 |
PUT |
範例
curl -X PUT \
-H "X-Ftcsys-key: {KEY}" \
-H "X-Accept-Language: {language}" \
-H "Content-Type: application/json" \
-d '{
"cinema_trans_id": "ef808081380e4b4701381cfcc0d91f1d",
"cinema_booking_id": "djehtekekf",
"cinema_trans_detail": [
{
"cinema_tras_detail_id": "ef808081380e4b4701381cfcc0d91f1e",
"cinema_return_price": 300
},
{
"cinema_tras_detail_id": "ef808081380e4b4701381cfcc0d91f1r",
"cinema_return_price": 240
}
],
"booking_num": "34556",
"wv_vista_trans_id": "2017120192837",
"cinema_trans_status": 40
}
https://{endpoint}/new_ez_order/ez_trans/update_ez_cinema_trans
回傳範例
< HTTP/1.1 200 OK
< Content-Type: application/json; charset=UTF-8
{
"result": [
{
"cinema_trans_id": "ef808081380e4b4701381cfcc0d91f1d"
}
],
"local_return": 23,
"code": 200,
"message": "交易成功",
"status": "success"
}
HTTP回應碼 |
結果 |
說明 |
401.116 |
"" |
平台代碼不可為空 |
401.121 |
"" |
影城交易代碼不可為空 |
401.119 |
"" |
場次ID不可為空 |
401.118 |
"" |
ez訂交易金鑰不可為空 |
404.105 |
"' |
ez訂交易金鑰不存在 |
401.108 |
"" |
交易類型代碼不可為空 |
401.122 |
"" |
訂票張數不可小於0 |
404.020 |
"" |
無此平台代碼 |
401.123 |
"" |
票種代碼不可為空 |
404.102 |
"" |
場次ID不存在 |
403.008 |
"" |
超過單次可訂票張數 |
403.002 |
"" |
已無連續座位,請重新選位 |
403.007 |
"" |
座位格式錯誤 |
403.006 |
"" |
網路訂票僅開放部分座位, 該場次網路訂票已無足夠空位, 請選擇其他場次,或至影城現場售票櫃台購票 |
400.101 |
"" |
影城系統連線失敗 |
400.102 |
"" |
影城系統忙碌中,請重新訂票 |
400.103 |
"" |
訂票系統忙碌中,請重新訂票 |
400.004 |
"" |
訂票時間逾時,請重選場次訂票 |
404.101 |
"" |
無此票種代碼 |
404.108 |
"" |
影城交易代碼不存在 |
401.127 |
"" |
影城交易id錯誤 |
403.999 |
"" |
參數錯誤 |
接收json參數
參數 |
名稱 |
範例 |
必填 |
備註 |
sid |
平台代碼 |
ezding |
Y |
|
cinema_trans_action |
影城交易類型 |
1 |
Y |
1:取消座位、2:設定座位、3:取消未完成訂票交易、4:確認訂單、5:取消已完成交易的訂單、6:查詢取票張數、7:查詢取票狀態 |
transaction_id |
影城交易代碼ID |
123412341234 |
Y |
|
ez_trans_hashkey |
ez訂交易金鑰 |
4b2df95b82e94321aeb18acdc72a9b44 |
Y |
|
cinema_trans_id |
影城交易id |
ef808081380e4b4701381cfcc0d91f1d |
Y |
|
cinema_booking_id |
影城交易序號 |
djehtekekf |
N |
|
booking_num |
影城取票序號 |
34556 |
N |
|
wv_vista_trans_id |
VISTA交易序號 |
2017120192837 |
N |
|
cinema_trans_status |
影城交易狀態 |
40 |
Y |
|
cinema_trans_detail |
影城交易明細 |
|
Y |
|
cinema_tras_detail_id |
影城交易明細資料檔id |
ef808081380e4b4701381cfcc0d91f1e |
Y |
|
cinema_return_price |
影城回傳金額 |
300 |
N |
回傳json的參數
參數 |
名稱 |
範例 |
必填 |
備註 |
ez_trans_hashkey |
ez訂交易金鑰 |
000e9016e6f94540b06b12e7e3cccc33 |
Y |
|
cinema_trans_id |
影城交易id |
ef808081380e4b4701381cfcc0d91f1d |
Y |