API說明
API位置 |
/new_ezding/comments |
需求描述 |
取得所有電影評分清單,排序規則:評分最高到最低>評論則數多到少 |
傳輸物件格式 |
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
< 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"
},
"poster_url": "電影海報所在位置",
"poster_id": "00001",
"grade": 1,
"release_date": 1491023655000,
"ez_score": 5,
"imdb_score": 7.8,
"rt_score": "78%",
"length": 148,
"current_ranking": 1,
"last_ranking": 2,
"order_availible": "true",
"sort": 1,
"status": 1
}
]
},
"code": 200,
"status": "success"
}
接收URL參數
參數 |
名稱 |
範例 |
必填 |
備註 |
page |
所在頁數 |
1 |
N |
|
page_size |
每頁要求的資料筆數 |
20 |
N |
|
order_by |
排序方式 |
0 |
Y |
預設以ez_score評分最高到最低排序>評論則數多到少,0:評分星等,以上映以來,累積平均星等ez_score評分最高到最低排序,1:上映日期,以上映時間最近到最遠排序,2:熱門,以一個月內訂票數最多到最少排序 |
valid |
資料狀態 |
1 |
Y |
1:傳回有效資料、0:傳回全部資料 |
回傳json的參數
參數 |
名稱 |
範例 |
必填 |
備註 |
total_pages |
總頁數 |
10 |
Y |
|
total_records |
結果筆數 |
100 |
Y |
|
page |
頁碼 |
1 |
Y |
|
list |
評分資料 |
|
Y |
|
movie_id |
電影群組ID |
c5516129d1e94c71841f09d3d18290e2 |
Y |
|
movie_poster_url |
電影海報所在位置 |
https://www.ezding.com.tw/00001.jpg |
|
|
movie_title |
電影名稱資料 |
|
Y |
|
zh_tw |
電影中文名稱 |
擺渡人 |
Y |
|
en_us |
電影英文名稱 |
ABC |
Y |
|
release_date |
上映日期 |
1491023655000 |
N |
|
ez_score |
ez訂會員評分平均值 |
4 |
N |
|
imdb_score |
imdb分數 |
7.8 |
N |
|
rt_score |
爛分茄分數 |
74% |
N |
|
length |
片長 |
148 |
Y |
|
current_ranking |
當前統計排行結果 |
1 |
Y |
目前排名,數字從小到大排序 |
last_ranking |
前次統計排行結果 |
1 |
Y |
前次統計排名,數字從小到大排序 |
order_availible |
是否可訂票 |
true |
Y |
true:有開演場次可訂票、fault:無開演場次不可訂票 |
sort |
排序 |
1 |
Y |
從小到大,預設9999 |