API說明
API位置 |
/new_ezding/members/order_list |
需求描述 |
查詢會員訂票記錄,排序規則:依訂票時間最新到最遠排序 |
傳輸物件格式 |
json |
方法 |
GET |
範例
curl -X GET \
-H " X-Ftcsys-key: {KEY}" \
-H " X-Ftc-Authorization: {token}" \
-H " X- Accept-Language: {language}" \
-H "Content-Type: application/json" \
http:
回傳範例
< HTTP/1.1 200 OK
< Content-Type: application/json; charset=UTF-8
{
"result": {
"total_pages": 6,
"total_records": 60,
"page": 1,
"list": [
{
"data_session": {
"session_id": "022a45f3450c4971b79fd0f2c6fca1d6",
"session_time": 1490572800000
},
"movie_id": "c5516129d1e94c71841f09d3d18290e2",
"movie_title": {
"zh_tw": "擺渡人",
"en_us": "ABC"
},
"poster_url": "電影海報圖所在位置",
"cinema_name": {
"zh_tw": "梅花影城",
"en_us": "Blossom"
},
"ticket_type": "電影版本",
"booking_number": "N123ABC",
"ticket_count": 2,
"seats": "M排11號,M排12號",
"ticket_price": "800 (此金額未含訂票手續費20元/張)",
"ticket_point": 800,
"booking_fee": 20,(<--6/7上線版先回傳null)
"order_id": "aa123",
"wv_booking_status": 0,
"is_comment": 0,(<--6/7上線版先回傳null)
"inv_no": 88888888,
"inv_date": 1487260800000,
"booked_date": 1497882000000,
"inv_amount": 20,
"sale_system":2
}
]
},
"code": 200,
"status": "success"
}
回傳錯誤 - 使用者帳號不存在
< HTTP/1.1 404 Not Found
< Content-Type: application/json; charset=UTF-8
{
"result": "",
"code": 404.001,
"status": "failure"
}
回傳錯誤 - 查無訂單
< HTTP/1.1 403 Bed Request
< Content-Type: application/json; charset=UTF-8
{
"code": 403,
"message": "查無訂單",
"status": "failure"
}
回傳錯誤 - 取消失敗
< HTTP/1.1 403 Bed Request
< Content-Type: application/json; charset=UTF-8
{
"code": 403.001,
"message": "你已完成取票,若欲辦理退票請於.......",
"status": "failure"
}
接收URL參數
參數 |
名稱 |
範例 |
必填 |
備註 |
is_show |
是否開演 |
1 |
Y |
0:未開演,1:已開演 |
page |
頁碼 |
1 |
N |
|
page_size |
每頁傳回資料筆數 |
10 |
N |
回傳json的參數
參數 |
名稱 |
範例 |
必填 |
備註 |
total_pages |
總頁數 |
10 |
Y |
|
total_records |
結果筆數 |
100 |
Y |
|
page |
所在頁數 |
1 |
Y |
|
list |
訂單清單 |
|
Y |
|
data_session |
電影場次資料 |
|
Y |
|
session_time |
場次時間 |
1491023655000 |
Y |
|
movie_title |
電影名稱資料 |
|
Y |
|
zh_tw |
電影中文名稱 |
擺渡人 |
Y |
|
en_us |
電影英文名稱 |
ABC |
Y |
|
poster_url |
電影海報圖檔所在位置 |
https://www.ezding.com.tw/00001.jpg |
Y |
|
cinema_name |
影城名稱 |
|
Y |
|
zh_tw |
影城中文名稱 |
梅花影城 |
Y |
|
en_us |
影城英文名稱 |
Blossom |
Y |
|
tiket_type |
電影版本 |
IMAX |
Y |
|
booking_number |
取票序號 |
N123ABC |
Y |
|
ticket_count |
張數 |
2 |
Y |
|
seats |
座位 |
M排11號,M排12號 |
Y |
|
ticket_price |
票價說明 |
800(此金額未含訂票手續費20元/張) |
Y |
|
ticket_point |
使用紅利點 |
800 |
Y |
沒有使用紅利點回傳null |
booking_fee |
訂票手續費 |
20 |
Y |
|
order_id |
訂單編號 |
00001 |
Y |
|
wv_booking_status |
取票狀態 |
0 |
Y |
0:未取票、1:已取票、2:已取消,取票狀態為2,不論為paid-booking或unpaid-booking的影城,就會顯示「已取消訂票」 |
is_comment |
是否評論 |
0 |
N |
0:未評論、1:已評論 |
inv_no |
發票號碼 |
88888888 |
N |
不論為paid-booking或unpaid-booking的影城,只要有發票號碼就會出現桃紅購買證明章 |
inv_date |
發票日期 |
1487260800 |
N |
|
inv_amount |
發票金額 |
20 |
N |
|
booked_date |
訂購日 |
1497882000000 |
N |
|
sale_system |
影城銷售系統 |
2 |
Y |
訂單狀態為已開演,取票狀態為0或1,2、7、8為paid-booking的影城,開演後會出現白色購買證明章;3、4、5、6為unpaid-booking影城,購買證明欄位須隱藏 |