API說明
API位置 |
/comments/{refrence_id} |
需求描述 |
取得指定電影/站台內容評論評分清單,排序規則:評論時間最新到最舊排序>評分最高到最低排序 |
傳輸物件格式 |
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": {
"comment_type": 1,
"total_pages": 10,
"total_records": 100,
"page": 1,
"list": [
{
"comment_id": "00001",
"user_name": "王**",
"score": "",
"comment": "喜歡❤️",
"created_time": 1487839684,
"reply": [
{
"user_name": "黃**",
"coment": "還不錯啊",
"created_time": 1487839688
},
{
"user_name": "黃**",
"coment": "還不錯啊",
"created_time": 1487839688
}
]
},
{
"user_name": "楊**",
"score": "3.3",
"comment": "整體來說還算不錯,可以看看",
"created_time": "1487839688"
},
{
"user_name": "黎**",
"score": "4",
"comment": "自行輸入評論",
"created_time": 1487839688
},
{
"user_name": "王**",
"score": "3.3",
"comment": "整體來說還算不錯,可以看看",
"created_time": 1487839688
},
{
"user_name": "王**",
"score": "3.3",
"comment": "超乎想像的好看,大推!",
"created_time": 1487839688
},
{
"user_name": "王**",
"score": "5",
"comment": "很好看。因為我喜歡魔法或有Power 的電影。所以我覺得好看。",
"created_time": 1487839688
},
{
"user_name": "林**",
"score": "3",
"comment": "自行輸入評論",
"created_time": 1487839688
},
{
"user_name": "林**",
"score": "5",
"comment": "超乎想像的好看,大推!",
"created_time": 1487839688
},
{
"user_name": "顏**",
"score": "4.8",
"comment": "超乎想像的好看,大推!",
"created_time": 1487839688
},
{
"user_name": "延**",
"score": "1.8",
"comment": "有一種看完像做完禪坐的fu",
"created_time": 1487839688
}
]
},
"code": 200,
"status": "success"
}
接收URL參數
參數 |
名稱 |
範例 |
必填 |
備註 |
refrence_id |
電影群組ID惑站台內容ID |
c5516129d1e94c71841f09d3d18290e2 |
Y |
|
page |
所在頁數 |
1 |
N |
|
page_size |
每頁要求的資料筆數 |
20 |
N |
|
valid |
資料狀態 |
1 |
N |
1:傳回有效資料、0:傳回全部資料 |
回傳json的參數
參數 |
名稱 |
範例 |
必填 |
備註 |
comment_type |
評論類型 |
1 |
Y |
1:電影評論、2:站台內容評論 |
total_pages |
總頁數 |
10 |
Y |
|
total_records |
結果筆數 |
100 |
Y |
|
page |
頁碼 |
1 |
Y |
|
list |
評分評論清單 |
|
Y |
|
user_name |
使用者暱稱 |
黃** |
Y |
|
score |
會員評分 |
4.5 |
N |
若評論類型為站台內容,score給null |
comment |
評論內容 |
很好喔 |
Y |
|
created_time |
建立時間 |
1487839688 |
Y |
|
reply |
會員回覆評論資料 |
|
N |