API說明
API位置 |
/new_ezding/ranking_list/comment_top |
需求描述 |
取得網路熱議電影排行榜清單條件:有開演場次的電影,不管有無上映,排序規則:前一個月評論數由大到小 |
傳輸物件格式 |
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 |
當前統計排行結果 |
1 |
Y |
目前排名,數字從小到大排序 |
last_ranking |
前次統計排行結果 |
1 |
Y |
前次統計排名,數字從小到大排序 |
order_availible |
是否可訂票 |
true |
Y |
true:有開演場次可訂票、fault:無開演場次不可訂票 |
sort |
排序 |
1 |
Y |
從小到大,預設9999 |
status |
狀態 |
1 |
Y |
1:上架、0:下架 |