API說明
API位置 | /new_ezding/ads |
---|---|
需求描述 | 取得banner、announcement清單 |
傳輸物件格式 | json |
方法 | GET |
範例
curl -X GET \
-H " X-Ftcsys-key: {KEY}" \
-H " X-Accept-Language: {language}" \
-H " Content-Type: application/json" \
https://{endpoint}/new_ezding/ads?ad_type=1&ad_category=ezding.rwd&ad_channel=5d5e5ed3184fedf201184fedf6eb0001&page_code
=home&area_code=mainBanner
回傳範例
< HTTP/1.1 200 OK
< Content-Type: application/json; charset=UTF-8
{
"result": [
{
"ad_type": 1,
"ad_group_id": "02159cf94005451089c5fe6da7fbd017",
"ad_title": "標題",
"ad_url_big": "大尺寸banner圖片所在位置",
"ad_url_medium": "中尺寸banner圖片所在位置",
"ad_url_small": "小尺寸banner圖片所在位置",
"ad_link": "點擊網址",
"cinema_id": "1b47c492287211e69b8d6f151a450c6d",
"ad_content": "",
"video_embed": "<iframe width=\"560\" height=\"315\" src=\"https://www.youtube.com/embed/8KAlFBVlmEs\" frameborder=\"0\" allowfullscreen></iframe>",
"show_type": 1,
"open_window": 1,
"begin_time": 1490073255000,
"end_time": 1493615655000,
"sort": 1,
"status": 1,
"click_count": 100//<--6/7上線先不傳
},
{
"ad_type": 2,
"ad_group_id": "00001",
"ad_title": "標題",
"ad_url_big": "",
"ad_url_medium": "",
"ad_url_small": "",
"ad_link": "點擊網址",
"cinema_id": "",
"ad_content": "信義威秀停電",
"video_embed": "",
"show_type": 1,
"open_window": 1,
"begin_time": 1490073255000,
"end_time": 1493615655000,
"sort": 1,
"status": 1,
"click_count": 100//<--6/7上線先不傳
}
],
"code": 200,
"status": "success"
}
接收URL參數
參數 | 名稱 | 範例 | 必填 | 備註 |
---|---|---|---|---|
ad_type | ad類型 | 1 | Y | 詳下方參數代碼表 |
ad_category | ad分類 | ezding.rwd | Y | 詳下方參數代碼表一一 |
ad_channel | ad頻道 | 5d5e5ed3184fedf201184fedf6eb0001 | Y | ez訂網站頻道代碼:5d5e5ed3184fedf201184fedf6eb0001,app頻道代碼:6cec77fe960e11e494ae8b4ddf78b93a。更多代碼詳參數代碼表二 |
page_code | 頁面代碼 | home | Y | 詳下方參數代碼表一 |
area_code | 區塊代碼 | mainBanner | Y | 詳下方參數代碼表一 |
ad_size | 圖檔尺寸 | 1 | N | 預設值為1,1:大、2:中、3:小 |
sort | 排序方式 | 0 | N | 預設值為 0,0:依sort欄位做正排序、1:依id做逆排序 |
amount | 資料筆數 | 10 | N | 預設值為 0,0:傳回全部資料 |
valid | 資料狀態 | 1 | N | 預設值為 1,1:傳回上架資料、0:傳回全部資料 |
回傳json的參數
參數 | 名稱 | 範例 | 必填 | 備註 |
---|---|---|---|---|
ad_group_id | ad群組ID | 02159cf94005451089c5fe6da7fbd017 | Y | ad_type=0,1,2 |
ad_title | 圖片標題 | 限制級戰警主視覺 | Y | ad_type=0,1,2 |
ad_content | 內容說明 | 信義威秀停電 | N | ad_type=0,2 |
video_embed | 內崁影片emebed code | <iframe width="560" height="315" src="https://www.youtube.com/embed/8KAlFBVlmEs" frameborder="0" allowfullscreen></iframe> | N | ad_type=0,1,2 |
ad_url_big | 大尺寸banner圖片所在位置 | https://www.ezding.com.tw/00002/1920_800.jpg | N | ad_type=0,1,Url組成規則:{enpoint}/{adGroupId}/圖檔名.副檔名 |
ad_url_medium | 中尺寸banner圖片所在位置 | https://www.ezding.com.tw/00002/1280_560.jpg | N | ad_type=0,1 |
ad_url_small | 小尺寸banner圖片所在位置 | https://www.ezding.com.tw/00002/768_560.jpg | N | ad_type=0,1 |
ad_link | 圖片點擊網址 | http://www.ezding.com.tw | N | ad_type=0,1,2 |
cinema_id | 影城ID | 1b47c492287211e69b8d6f151a450c6d | N | ad_type=0,1,2 |
show_type | 輪播類型 | 0 | N | ad_type=0,1,2,0:只秀一次、1:每次都秀 |
open_window | 是否開啟新視窗 | 0 | N | ad_type=0,1,2,1:是、0:否 |
begin_time | 上架時間 | 1490073255000 | Y | ad_type=0,1,2 |
end_time | 下架時間 | 1493615655000 | Y | ad_type=0,1,2 |
sort | 排序 | 1 | Y | ad_type=0,1,2,從小到大,預設9999 |
status | 狀態 | 1 | Y | ad_type=0,1,2,1:上架、0:下架 |
click_count | 點擊數(6/7上線先不傳) | 100 | N | ad_type=0,1,2,點擊數 |
參數代碼表一
參數名稱 | 代碼 | 說明 | 備註 |
---|---|---|---|
ad_type | 0 | 全部 | |
1 | banner | ||
2 | 公告 | ||
ad_category | channel | 站台 | 只有ad_type=2 |
ezding.rwd | RWD站台 | 只有ad_type=1 | |
ezding.app | APP站台(app用) | 只有ad_type=1 | |
content_code | web_new.home.banner | RWD首頁 | 只有ad_type=1 |
ezding.banner.smartphone.homeTop | APP首頁(app用) | 只有ad_type=1 | |
channel.booking.finish.banner | 訂票完成頁 | 只有ad_type=1 | |
ezding.app.member.banner | app會員中心頁(app用) | 只有ad_type=1 | |
ezding.rwd.movie.express.home | 文章列表頁 | 只有ad_type=1 | |
ezding.rwd.movie.express.detail | 文章詳細頁 | 只有ad_type=1 | |
channel.notice | 站台公告 | 只有ad_type=2 | |
page_code | home | 首頁 | 只有ad_type=1 |
booking_finish | 訂票完成 | 只有ad_type=1 | |
app_member_home | APP會員中心頁(app用) | 只有ad_type=1 | |
movie_express_home | 文章列表頁 | 只有ad_type=1 | |
movie_express_detail | 文章詳細頁 | 只有ad_type=1 | |
notice | 公告 | 只有ad_type=2 | |
area_code | mainBanner | 主視覺區塊banner | 只有ad_type=1 |
eventBanner | 三張輪播banner | 只有ad_type=1 | |
appEvent | app會員中心活動banner(app用) | 只有ad_type=1 | |
appProBanner | 320置頂導下載區塊banner | 只有ad_type=1 | |
finishBooking | 訂票完成頁 | 只有ad_type=1 | |
proBanner | 各活動banner | 只有ad_type=1 | |
notice | 公告 | 只有ad_type=2 |
ad_channel參數代碼表二
ad_channel(reference_id) | 分站名稱 | 代碼 |
---|---|---|
43d7c6b6ccd411e292f7000bdb90dba4 | 美國運通銀行 | aexp |
382a2e860c8011e29448e41f136a9614 | 澳盛銀行信用卡 | anz |
a3c4bffe262511e6a941e41f136a9614 | appledaily | appledaily |
4329059ea5c311e4bdb11f40e1a9a955 | asus | asus |
c54dcc18-9f27-102d-afd6-0040f4b0 | 開眼網 | atmovie |
90bf4c9e209a11e5a708e41f136a9614 | 電影筆記 | biji |
52be1e7db02211df80e9bb0c0b123bf1 | 群益證券 | capital |
c898a1407bb411e59d9e40dc9141931f | cardu | cardu |
cf0b0d1a1bc811e18e86000bdb90dba4 | catchplay | catchplay |
4b3636b0e750102db4e7000d609aa7fa | 國泰世華悠遊卡 | cathaybk |
636e1bd54ed411e09619ab1f989c4892 | 國泰世華NBA卡 | cathaybknba |
5b0d2862b2a011e0ada8000bdb90dba4 | 時報資訊 | chinatimes |
5d5e5ed32133e146012133e14d120001 | 中信信用卡 | chinatrust |
49e0db50ec3911e1ac0de41f136a9614 | cnyes | cnyes |
630a460e013c11e18e86000bdb90dba4 | 賽微科技 | cyberon |
5d5e5ed31d3d00b6011d3d00bd110001 | 玉山信用卡 | esunbank |
f010cd92ec3311e1ac0de41f136a9614 | eten | eten |
2650f526d46b11e58b8ae41f136a9614 | ETtoday | ETtoday |
45f3ebd465b811e683df001a64e5f7b0 | eureka | eureka |
88513af8a10e11e434ae8b4ddf78b888 | EZBonus | EZBonus |
5d5e5ed3184fedf201184fedf6eb0001 | ezDing網站 | ezding |
6cec77fe960e11e494ae8b4ddf78b93a | ezDingApp | ezDingApp |
cdd107008b7211e6bcd2e41f136a9614 | EZPackage | EZPackage |
9d963040c60a11e39eb3e41f136a9614 | 臉書 | |
ffeb06f226bc11e18e86000bdb90dba4 | 第一銀行 | firstcard |
67a011f89c0f11e68b95e8a78dce627d | friday | friday |
ee791d5a8c7811e292f7000bdb90dba4 | 台北富邦銀行 | fubon |
8630430bfcfd11dfbfd20ac1ad1d8b62 | 遊戲基地 | gamebase |
719ec1d093b211e3afe9e41f136a9614 | gs8 | gs8 |
9f88619ccbf811e19ec9000bdb90dba4 | 好康多 | hks |
23c92f70638b11e292f7000bdb90dba4 | 華南銀行 | hncb |
db56cf72c37411e3be9ee41f136a9614 | 好享看 | holyshare |
29bdaa87-a7e5-11de-987d-03c7dcfa | 滙豐信用卡 | hsbc |
9280290c949c11e494ae8b4ddf78b93a | ibon | ibon |
9bbfed66a52411e4bdb11f40e1a9a955 | jeavins | jeavins |
4696865a91ef11e292f7000bdb90dba4 | 日盛銀行 | jsun |
4ccf7aba8ae511e292f7000bdb90dba4 | jumplife | jumplife |
86ffb6c08ad911e292f7000bdb90dba4 | justmovie | justmovie |
898c676e87c111e292f7000bdb90dba4 | 台灣大寬頻 | kbro |
ef513af8a10e11e434ae8b4ddf78b93a | LINEPay | LINEPay |
16bf314651de11e59c99e41f136a9614 | luna | luna |
92653a30586c11e18e86000bdb90dba4 | 兆豐信用卡 | megabank |
c03c6a1e38a111e0a1be000bdb90dba4 | Moovy | moovy |
88817232270a11e29448e41f136a9614 | movieexpress | movieexpress |
4d39df986ffd11e292f7000bdb90dba4 | moviego | moviego |
1066dac2ed4611e38b12000bdb90dba4 | newminshen | newminshen |
d7146a606f1011e18e86000bdb90dba4 | 全國加油站 | npcgas |
259e715a4bdd11e18e86000bdb90dba4 | catchplay手機&友好網站 | nwc |
ef513af8a10e11e494ae8b4ddf78b93a | payeasy | payeasy |
b8c2e9c2bb4811e19ec9000bdb90dba | pchome | pchome |
54b8cd4b-4afa-102d-be50-a8414bb4 | 痞客邦 | pixnet |
e5872eca8fde11e3afe9e41f136a9614 | samsung | samsung |
df4563e093af11e3afe9e41f136a9614 | sanlih | sanlih |
e00fa5f84dbb11e4968d8f9c61102baa | 渣打銀行 | scbank |
881184415ef911dfb7cf721e41e9d054 | 上海銀行信用卡 | scsb |
6854395c13d111e59e5e8d16c6a1d23a | scsbm | scsbm |
1e071fce288211e69b8d6f151a450c6d | security | security |
c346cbeb391211e795ff061be09fe071 | SHOPBACK | shopback |
5d5e5ed319e539790119e5397fba0001 | 永豐信用卡 | sinopac |
f80aa9c8086711e780fc061be09fe071 | 永豐三井MOP卡 | sinopacoutlet |
5d5e5ed31810bde3011810bde7ff0001 | 新光信用卡 | skbank |
29c88216-a7e5-11de-987d-03c7dcfa | 匯豐VISA金融卡 | smartcard |
5d5e5ed321ed76a80121ed76af6a0001 | 晶片金融卡 | smartpay |
d83da7423b6e11e18e86000bdb90dba4 | 台茂美麗華 | taimall |
5d5e5ed31c0cf03c011c0cf041010001 | 台新信用卡 | taishin |
e7beff7a69d211e292f7000bdb90dba4 | 大眾銀行 | tcbank |
eda2f618bb5411e58b8ae41f136a9614 | transiot | transiot |
47728662b1a611e0b090000bdb90dba4 | 聯邦銀行信用卡 | ubank |
ed3329d27c4d11e59d9e40dc9141931f | uber | uber |
b50f51d6b2a111e0ada8000bdb90dba4 | 聯合報系 | udn |
b7af6e206c5411e392f7000bdb90dba4 | visa | visa |
48b9fb84053611e6a941e41f136a9614 | worldscreen | worldscreen |
bc88a40210a011e4968d8f9c61102baa | wovie | wovie |
0d8272b2591a11e08398000bdb90dba4 | YAHOO雅虎 | yahoo |
862e05f9fcfd11dfbfd20ac1ad1d8b62 | Yam天空 | yam |
fa5d6af6593211e18e86000bdb90dba4 | 元大銀行 | yuanta |