API說明
| API位置 |
/new_ezding/ranking_list/coming |
| 需求描述 |
取得即將上映電影清單條件：未上映的電影，不管有無開演場次，排序規則：電影上映日期由最近到最遠 |
| 傳輸物件格式 |
json |
| 方法 |
GET |
範例
curl -X GET \
-H " X-Ftcsys-key: {KEY}" \
-H " X-Accept-Language: {language}" \
-H " Content-Type: application/json" \
https:
回傳範例
< HTTP/1.1 200 OK
< Content-Type: application/json; charset=UTF-8
{
"result": {
"total_Pages": 2,
"total_Records": 10,
"page": 1,
"list": [
{
"movie_id": "c5516129d1e94c71841f09d3d18290e2",
"movie_title": {
"zh_tw": "擺渡人",
"en_us": "ABC"
},
"release_date": 1491023655000,
"grade": 1,
"poster_url": "電影海報所在位置",
"poster_id": "00001",
"length": 148,
"imdb_score": 7.8,
"rt_score": "78%",
"ez_score": 5,
"comment_count": 3,
"current_ranking": 1,
"last_ranking": 2,
"order_availible": true,
"sort": 1,
"status": 1
}
]
},
"code": 200,
"status": "success"
}
接收URL參數
| 參數 |
名稱 |
範例 |
必填 |
備註 |
| page |
所在頁數 |
1 |
Y |
|
| page_size |
每頁要求的資料筆數 |
10 |
Y |
回傳json的參數
| 參數 |
名稱 |
範例 |
必填 |
備註 |
| total_pages |
總頁數 |
2 |
Y |
|
| total_records |
總結果筆數 |
10 |
Y |
|
| page |
所在頁數 |
1 |
Y |
|
| movie_id |
電影群組ID |
c5516129d1e94c71841f09d3d18290e2 |
Y |
|
| movie_title |
電影名稱資料 |
|
Y |
|
| zh_tw |
電影中文名稱 |
擺渡人 |
Y |
|
| en_us |
電影英文名稱 |
ABC |
Y |
|
| poster_url |
電影海報所在位置 |
http://l10l010l3322ll.photos.atmovies.com.tw:8080/2017/K/fken53731562/poster/px_fken53731562_0005.jpg |
Y |
回傳poster_size=1的，sort數字較小的電影海報所在位置 |
| poster_id |
電影海報ID |
00001 |
Y |
|
| grade |
電影分級 |
1 |
N |
0:普遍級、1:保護級、2:輔12級、3:輔15級、4:限制級 |
| release_date |
上映日期 |
1491023655000 |
N |
|
| ez_score |
ez訂會員評分平均值 |
4 |
N |
|
| imdb_score |
imdb分數 |
7.8 |
N |
|
| rt_score |
爛番茄分數 |
78% |
N |
|
| comment_count |
總評論數 |
3 |
N |
|
| length |
片長 |
148 |
Y |
|
| current_ranking |
當前統計排行結果 |
|
N |
即將上映無排行名次 |
| last_ranking |
前次統計排行結果 |
|
N |
即將上映無前次排行名次 |
| order_availible |
是否可訂票 |
true |
Y |
true:有開演場次可訂票、fault:無開演場次不可訂票 |
| sort |
排序 |
1 |
Y |
從小到大，預設9999 |
| status |
狀態 |
1 |
Y |
1:上架、0:下架 |