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://{endpoint}/new_ezding/comments?order_by=0&valid=1

回傳範例

< 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

results matching ""

    No results matching ""