API說明
API位置 |
/new_ezding/contents |
需求描述 |
取得站台內容/作者的內容清單 |
傳輸物件格式 |
json |
方法 |
GET |
範例
curl -X GET \
-H " X-Ftcsys-key: {KEY}" \
-H " X-Ftc-Authorization: Bearer {token}" \
-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": 10,
"total_records": 100,
"page": 1,
"list": [
{
"content_id": 413,
"content_category": "movie_express",
"content_type": "news",
"content_title": "將將測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試",
"author": {
"author_id": 7,
"author_name": "ez訂電影",
"author_photo": "https://www.ezding.com.tw/content/author/photos/000001/643887_163152190497403_232281730_n.jpg",
"author_desc": "發布最新電影情報,內容合作、新聞稿投遞及編輯群聯繫,請發信至[email protected],謝謝~"
},
"begin_time": 1496401367000,
"end_time": null,
"created_time": 1496401367000,
"sort": null,
"status": 1,
"click_count": 39,
"first_image": "http://theplaylist.net/wp-content/uploads/2017/06/Mary-And-The-Witchs-Flower-1200x520.jpg",
"content_detail": "<p>\r\n\t<img alt=\"\" src=\"http://theplaylist.net/wp-content/uploads/2017/06/Mary-And-The-Witchs-Flower-1200x520.jpg\" style=\"width: 550px; height: 238px;\" /></p>\r\n<p>\r\n\t測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試</p>\r\n<p>\r\n\t測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試</p>\r\n<p>\r\n\t測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試</p>\r\n<p>\r\n\t測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試</p>\r\n<p>\r\n\t測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試測試</p>",
"eval": 0,
"top": 1,
"event": 1,
"feature": 1,
"content_bookmark_status": 0,
"content_bookmark_type": 1,(<-7/7新增)
"author_bookmark_status": 0,
"author_bookmark_type": 1,(<-7/7新增)
"content_tag": null,
"movie_id": null,
"movie_title": {
"zh_tw": null,
"en_us": null
}
}
]
},
"code": 200,
"status": "success"
}
接收URL參數
參數 |
名稱 |
範例 |
必填 |
備註 |
|
content_category |
內容類別代碼 |
movie_express |
N |
movie_express:電影快報代碼(其他內容代碼視需求陸續新增) |
|
content_type |
內容子類別代碼 |
news |
N |
預設傳回所有子類別結果,以電影快報子類別為例:news:新聞、cinecism:影評、topic:專題、other:其他 |
|
movie_id |
電影ID |
000e9016e6f94540b06b12e7e3cccc33 |
N |
|
|
author_id |
作者ID |
12 |
N |
|
|
page_size |
每頁的結果筆數 |
10 |
N |
|
|
page |
頁碼 |
1 |
N |
|
|
sort_type |
排序方式 |
1 |
N |
預設值為1,1:依上架時間最新到最舊排序、2:依一個月內瀏覽量最多到最少排序 |
|
top |
置頂文章 |
1 |
N |
1:置頂文章、0:非置頂文章 |
|
feature |
精選文章 |
1 |
N |
1:精選文章、0:非精選文章 |
|
valid |
狀態 |
1 |
Y |
1:傳回上架資料、0:傳回全部資料 |
回傳json的參數
參數 |
名稱 |
範例 |
必填 |
備註 |
total_pages |
總頁數 |
2 |
Y |
|
total_records |
總結果筆數 |
10 |
Y |
|
page |
所在頁數 |
1 |
Y |
|
content_id |
內容ID |
512 |
Y |
|
content_category |
內容類別代碼 |
movie_express |
Y |
movie_express:電影快報代碼(其他內容代碼視需求陸續新增) |
content_type |
內容子類別代碼 |
news |
N |
預設傳回所有子類別結果,以電影快報子類別為例:news:新聞、cinecism:影評、topic:專題、other:其他 |
content_title |
內容標題 |
布萊德彼特新片【同盟鶼鰈】,榮登新片票房王! |
Y |
|
first_image |
內容首張圖片所在位置 |
https://pic.pimg.tw/applause29/1488294599-1865053136_n.jpg |
Y |
|
author |
作者資料 |
|
Y |
|
author_id |
作者ID |
18 |
Y |
|
author_name |
作者姓名 |
左撇子 |
Y |
|
author_photo |
作者頭像 |
https://www.ezding.com.tw/content/author/photos/000001/643887_163152190497403_232281730_n.jpg |
Y |
|
author_desc |
作者簡介 |
超級愛看電影的人 |
N |
|
content |
內容 |
故事背景是建立在《X戰警:未來昔日》後五年的西元2029年,此時的變種人大都已經死亡或被殺害,剩下年邁且漸漸失去自癒能力的金鋼狼和患有腦部疾病的X教授相依為命此時一位名為Laura的小女孩突然出現,且 |
Y |
前端顯示摘要,截斷字元由前端控制 |
eval |
有雷無雷 |
1 |
Y |
0:無雷、1:有雷 |
top |
是否置頂 |
1 |
Y |
0:否、1:是 |
event |
是否有活動 |
1 |
Y |
0:否、1:是 |
feature |
是否為精選 |
1 |
Y |
0:否、1:是 |
content_bookmark_status |
是否收藏內容 |
1 |
N |
0:否、1:是 |
content_bookmark_type |
收藏類型(內容) |
1 |
N |
1:愛心 |
author_bookmark_status |
是否收藏作者 |
1 |
N |
0:否、1:是 |
author_bookmark_type |
收藏類型(作者) |
1 |
N |
1:愛心 |
created_time |
建立時間 |
1490073255000 |
N |
|
begin_time |
上架時間 |
1490073255000 |
Y |
|
end_time |
下架時間 |
null |
N |
|
sort |
排序 |
1 |
Y |
由大到小,預設值:9999,6/1上線版本先塞null |
status |
狀態 |
1 |
Y |
1:上架、0:下架 |
click_count |
點擊數 |
100 |
N |
點擊數 |