API說明
API位置 |
/new_ezding/contents/simple |
需求描述 |
取得站台內容清單 |
傳輸物件格式 |
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": 10,
"total_records": 100,
"page": 1,
"list": [
{
"content_id": "512",
"content_category": "movie_express",
"content_type": "news",
"content_title": "內容標題",
"author": {
"author_id": 18,
"author_name": "左撇子",
"author_photo": "https://www.ezding.com.tw/content/author/photos/000001/643887_163152190497403_232281730_n.jpg",
"author_desc": "超級愛看電影,更愛寫電影,尤其是漫威相關的電影,超級愛看電影,更愛寫電影,尤其是漫威相關的電影,超級愛看電影,更愛寫電影,尤其是漫威相關的電影,超級愛看電影,更愛寫電影,尤其是漫威相關的電影,超級愛看電影,更愛寫電影,尤其是漫威相關的電影"
},
"created_time": "null",
"begin_time": "null",
"end_time": "null",
"sort": 1,
"status": 1,
"click_count": 100
}
]
},
"code": 200,
"status": "success"
}
接收URL參數
參數 |
名稱 |
範例 |
必填 |
備註 |
content_category |
內容類別代碼 |
movie_express |
Y |
movie_express:電影快報代碼(其他內容代碼視需求陸續新增) |
content_type |
內容子類別代碼 |
news |
Y |
預設傳回所有子類別結果,以電影快報子類別為例:news:新聞、cinecism:影評、topic:專題、other:其他 |
page_size |
每頁的結果筆數 |
10 |
N |
|
page |
頁碼 |
1 |
N |
|
sort |
排序方式 |
1 |
N |
預設值為1,1:依建立時間最新到最舊排序、2:依建立時間最舊到最新排序 |
valid |
狀態 |
1 |
Y |
1:傳回上架資料、0:傳回全部資料 |
回傳json的參數
參數 |
名稱 |
範例 |
必填 |
備註 |
total_pages |
總頁數 |
2 |
Y |
|
total_records |
總結果筆數 |
10 |
Y |
|
page |
所在頁數 |
1 |
Y |
|
content_id |
內容ID |
512 |
Y |
|
content_category |
內容類別代碼 |
movieExpress |
Y |
movie_express:電影快報代碼(其他內容代碼視需求陸續新增) |
content_type |
內容子類別代碼 |
news |
Y |
預設傳回所有子類別結果,以電影快報子類別為例:news:新聞、cinecism:影評、topic:專題、other:其他 |
content_title |
內容標題 |
布萊德彼特新片【同盟鶼鰈】,榮登新片票房王! |
Y |
|
author |
作者資料 |
|
Y |
|
author_id |
作者ID |
18 |
N |
|
author_name |
作者姓名 |
左撇子 |
Y |
|
author_photo |
作者頭像 |
https://www.ezding.com.tw/content/author/photos/000001/643887_163152190497403_232281730_n.jpg |
N |
|
author_desc |
作者簡介 |
超級愛看電影的人 |
N |
|
created_time |
建立時間 |
null |
Y |
|
begin_time |
上架時間 |
null |
Y |
|
end_time |
下架時間 |
null |
Y |
|
sort |
排序 |
1 |
Y |
由小到大,預設值:9999 |
status |
狀態 |
1 |
Y |
1:上架、0:下架 |
click_count |
點擊數 |
100 |
N |
點擊數 |