API 說明

API Documentation

資料授權條款

說明文章授權條款

除 /musics 資料以外 採用 Creative Commons Attribution 4.0 International License 條款，即為：
1. 要有來源標示（柯文哲野生官網）
2. 可以自由利用（無論營利與否），具體細節請參考上述條款。
/musics 音樂內容授權：
1. 不可重製
2. 僅可在非商業用途前提下播放音樂
3. 要有來源(柯文哲野生官網)、平台(soundcloud)與音樂作者標示

文章類別查詢

用來取得目前官網文章類別清單

GET http://api.kptaipei.tw/v1/category/?accessToken=[YOUR_API_KEY]

[YOUR_API_KEY] 的部分在首頁可填寫申請 API KEY 。

資料範例：

{
  "isSuccess": true,
  "errorCode": 0,
  "data": [
    {
      "name": "【柯P新政】",
      "id": "40"
    },
    {
      "name": "【真・柯文哲】",
      "id": "41"
    },
    {
      "name": "新聞稿",
      "id": "42"
    }
  ],
  "errorMessage": null
}

類別內容查詢

給定類別 ID (可由 /category 取得) 後，可取得該類別底下文章清單。

GET http://api.kptaipei.tw/v1/category/<CATEGORY_ID>?accessToken=[YOUR_API_KEY]

資料範例：

{
  "isSuccess": true,
  "errorCode": 0,
  "errorMessage": null,
  "data": [
    {
      "id": 3007,
      "title": "【柯p新政】14-先進節能城市",
      "post_date": "2014-08-15T06:09:01.000Z",
      "author": "柯文哲",
      "last_modify": "2014-08-19T01:40:22.000Z",
      "url": "http://kptaipei.tw/?page_id=3007",
      "category_name": "【柯P新政】",
      "category_id": 40,
      "content": "<iframe width=\"560\" height=\"315\" src=\"//www.youtube.com/embed/03eaS6qp4ow\" frameborder=\"0\" allowfullscreen></iframe><hr />\n<h3 class=\"special-h-tag\" style=\"color: \">先進節能城市</h3><br />\n<div class=\"special-heading-wrap style3 \" data-animation=\"fadeIn\"><div class=\"caption-wrap\"><h6 class=\"caption\" style=\"color:#999999;\">【柯P新政】#14<span class=\"caption-inner\" style=\"background-color:#efefef;\"></span></h6></div></div><h3 class=\"p1\" style=\"text-align: center;\"><span class=\"s1\">「柯Ｐ新政」NO.14  打造先進節能城市</span></h3>\n<p class=\"p1\" style=\"text-align: center;\"><strong><span class=\"s1\">台北市熱島效應嚴重  柯P推海綿城市、綠建築</span></strong></p>\n<p class=\"p1\" style=\"text-align: center;\"><span class=\"s1\">台北市長參選人柯文哲繼先前推出的13支政策說明影片，今（8/15）日首次針對「能源」提出政見，主張將台北市打造成「先進節能城市」。柯文哲認為，核四停建以後，台灣社會必須在產業政策、能源政策、節能政策作一些調整，他舉例，產業政策不能再發展高耗能高汙染產業；能源政策則必須發展替代能源，如：太陽能、風力、水力、潮汐、生質能源，而節能政策則要推廣綠建築、智慧建築來減少能源的損耗。</span></p>\n<p class=\"p1\" style=\"text-align: center;\"><span class=\"s1\">柯文哲指出，過去100年北半球增加了0.7度C，而台灣的都會區則增加了1.5度C，1980年以後，台北市的溫度增加比花蓮、台東、恆春高出了2倍，台北市在夏日中午的時候，溫度也比週邊的郊區高出了4.5度C，由此可見，台北市的熱島效應最為嚴重。</span></p>\n<p class=\"p1\" style=\"text-align: center;\"><span class=\"s1\">針對這個困境，柯文哲提出了幾點節能策略。第一，建設一個水冷散熱的「海綿城市」，柯文哲分析，台北市用電量在夏季最多，又以中午時段達到高峰，因此要節省空調最重要的是降溫。柯文哲表示，台北市熱島效應最大原因是過度的水泥化、道路及建物吸熱但不散熱，導致悶熱的天氣增加，使用冷氣的時間、日數也增加。</span></p>\n<p class=\"p1\" style=\"text-align: center;\"><span class=\"s1\">至於實際做法，柯文哲提倡市區的道路或廣場改成透水性的鋪面，鋪面縫隙當中並沒有封死，下雨的時候可以讓水滲到地底下，不會積在地面上，而當太陽出來時，這些水又可以蒸發來降低整個環境的溫度。此外，在空曠地廣設貯水池，讓屋頂跟路面上的積水可以流進去，同樣達到「雨天儲水，晴天散熱」的效果。柯文哲也強調，要全面綠化、屋頂綠化，以及種樹不砍樹。</span></p>\n<p class=\"p1\" style=\"text-align: center;\"><span class=\"s1\">節能策略二，推廣綠建築和智慧建築，柯文哲主張，公共建築必須是節能省電的綠建築和智慧建築，一般建築凡是用電量低於標準的，電費應當給予打折優待；用電超過標準的，則市政府應當聘請節能公司免費協助輔導改善。柯文哲更鼓勵，凡是使用隔熱外牆、遮陽板、隔熱玻璃、省電照明、省電設備的建築，政府會協助融資，給予一定額度的補助，甚至直接從房屋稅跟地價稅來抵扣。</span></p>\n<p class=\"p1\" style=\"text-align: center;\"><strong><span class=\"s1\">柯文哲：我當市長，要讓經濟成長，用電零成長</span></strong></p>\n<p class=\"p2\" style=\"text-align: center;\">談到「開源」，柯文哲認為必須積極發展太陽能，因為比我們條件更差的國家，像德國、日本，過去幾年都在大量發展太陽能發電，柯文哲指出，目前中央政府採取屋頂設太陽能板的政策，作法是緩不濟急，因此只要台電願意以合理的價格來收購，柯文哲主張公開招商，由發電廠商來投資設立太陽能電廠。至於如何使用公共空間來設置太陽能板，柯文哲則說，像快速道路、捷運高架道、河濱高灘地、南向山坡地都可以利用。</p>\n<p class=\"p1\" style=\"text-align: center;\"><span class=\"s1\">柯文哲也提出幾點鼓勵開源節流的做法，包括未來台北市將鼓勵優先採購綠能農場的農漁產品，如：太陽能溫室和風力電場所生產的農漁產品。</span> </p>\n<p class=\"p1\" style=\"text-align: center;\"><span class=\"s1\">柯文哲表示，未來傳統的能源會越來越貴，而核能又不安全，因此必須要有其他的替代方案，柯文哲強調，要積極調整台北市的產業政策、能源政策和節能政策，努力開源節流。柯文哲說，他若當選台北市長，「要讓經濟成長，用電零成長」。</span></p>\n<br />\n<h3 class=\"special-h-tag\" style=\"color: \">柯P的主張</h3><div class=\"sub-title\"><p>柯文哲的政策主張，不是什麼大建設或軸線翻轉，而是貼近市民生活的道路挖補、食品安全、教育與醫療資源的平等。從醫生轉換為素人參政，我始終認為，不管是政治人物或媒體，都應該堅守基本的道德與價值，否則就會造成信任的崩解，人民之間不互信，更不相信政府，這是目前台灣社會空轉的重要原因。對我而言，這不只是一場選舉而已，它更是一場改變政治、改變選舉文化的社會運動。</p></div><hr class=\"separator style-2\" style=\"background-color:#efefef;border-color:#efefef;color:#efefef;\"><br />\n<div class=\"special-heading-wrap style1 0\" data-animation=\"fadeIn\"></div><br />",
      "plain_content": "[http://www.youtube.com/watch?v=03eaS6qp4ow]\n先進節能城市\n【柯P新政】#14「柯Ｐ新政」NO.14  打造先進節能城市\n台北市熱島效應嚴重  柯P推海綿城市、綠建築\n台北市長參選人柯文哲繼先前推出的13支政策說明影片，今（8/15）日首次針對「能源」提出政見，主張將台北市打造成「先進節能城市」。柯文哲認為，核四停建以後，台灣社會必須在產業政策、能源政策、節能政策作一些調整，他舉例，產業政策不能再發展高耗能高汙染產業；能源政策則必須發展替代能源，如：太陽能、風力、水力、潮汐、生質能源，而節能政策則要推廣綠建築、智慧建築來減少能源的損耗。\n柯文哲指出，過去100年北半球增加了0.7度C，而台灣的都會區則增加了1.5度C，1980年以後，台北市的溫度增加比花蓮、台東、恆春高出了2倍，台北市在夏日中午的時候，溫度也比週邊的郊區高出了4.5度C，由此可見，台北市的熱島效應最為嚴重。\n針對這個困境，柯文哲提出了幾點節能策略。第一，建設一個水冷散熱的「海綿城市」，柯文哲分析，台北市用電量在夏季最多，又以中午時段達到高峰，因此要節省空調最重要的是降溫。柯文哲表示，台北市熱島效應最大原因是過度的水泥化、道路及建物吸熱但不散熱，導致悶熱的天氣增加，使用冷氣的時間、日數也增加。\n至於實際做法，柯文哲提倡市區的道路或廣場改成透水性的鋪面，鋪面縫隙當中並沒有封死，下雨的時候可以讓水滲到地底下，不會積在地面上，而當太陽出來時，這些水又可以蒸發來降低整個環境的溫度。此外，在空曠地廣設貯水池，讓屋頂跟路面上的積水可以流進去，同樣達到「雨天儲水，晴天散熱」的效果。柯文哲也強調，要全面綠化、屋頂綠化，以及種樹不砍樹。\n節能策略二，推廣綠建築和智慧建築，柯文哲主張，公共建築必須是節能省電的綠建築和智慧建築，一般建築凡是用電量低於標準的，電費應當給予打折優待；用電超過標準的，則市政府應當聘請節能公司免費協助輔導改善。柯文哲更鼓勵，凡是使用隔熱外牆、遮陽板、隔熱玻璃、省電照明、省電設備的建築，政府會協助融資，給予一定額度的補助，甚至直接從房屋稅跟地價稅來抵扣。\n柯文哲：我當市長，要讓經濟成長，用電零成長\n談到「開源」，柯文哲認為必須積極發展太陽能，因為比我們條件更差的國家，像德國、日本，過去幾年都在大量發展太陽能發電，柯文哲指出，目前中央政府採取屋頂設太陽能板的政策，作法是緩不濟急，因此只要台電願意以合理的價格來收購，柯文哲主張公開招商，由發電廠商來投資設立太陽能電廠。至於如何使用公共空間來設置太陽能板，柯文哲則說，像快速道路、捷運高架道、河濱高灘地、南向山坡地都可以利用。\n柯文哲也提出幾點鼓勵開源節流的做法，包括未來台北市將鼓勵優先採購綠能農場的農漁產品，如：太陽能溫室和風力電場所生產的農漁產品。 \n柯文哲表示，未來傳統的能源會越來越貴，而核能又不安全，因此必須要有其他的替代方案，柯文哲強調，要積極調整台北市的產業政策、能源政策和節能政策，努力開源節流。柯文哲說，他若當選台北市長，「要讓經濟成長，用電零成長」。\n\n柯P的主張柯文哲的政策主張，不是什麼大建設或軸線翻轉，而是貼近市民生活的道路挖補、食品安全、教育與醫療資源的平等。從醫生轉換為素人參政，我始終認為，不管是政治人物或媒體，都應該堅守基本的道德與價值，否則就會造成信任的崩解，人民之間不互信，更不相信政府，這是目前台灣社會空轉的重要原因。對我而言，這不只是一場選舉而已，它更是一場改變政治、改變選舉文化的社會運動。\n"
    }
  ],
  "pageInfo": {
    "totalResults": 1,
    "resultsPerPage": 500
  }
}

參數

GET page=?: 第幾頁 (optional,default:0)
GET page_size=?: 一次顯示幾筆 (optional,default:100,max:500)

相簿清單查詢

柯文哲每天的行程都有許多紀錄，在這你可以找到所有相簿

GET http://api.kptaipei.tw/v1/albums/?accessToken=[YOUR_API_KEY]

資料範例：

{
  "isSuccess": true,
  "errorCode": 0,
  "errorMessage": null,
  "data": [
    {
      "id": "72157646357158490",
      "photos": "18",
      "videos": 0,
      "title": "2014.8.23圖書教育用品後援會",
      "description": "",
      "date_create": 1408802369000,
      "date_update": 1408802386000,
      "link": "https://www.flickr.com/photos/110839995@N06/sets/72157646357158490/",
      "thumbnails": {
        "small": "https://farm6.staticflickr.com/5588/14985662396_fcb33afc3e_n.jpg",
        "small_square": "https://farm6.staticflickr.com/5588/14985662396_fcb33afc3e_s.jpg",
        "large_square": "https://farm6.staticflickr.com/5588/14985662396_fcb33afc3e_q.jpg",
        "thumbnail": "https://farm6.staticflickr.com/5588/14985662396_fcb33afc3e_t.jpg",
        "medium": "https://farm6.staticflickr.com/5588/14985662396_fcb33afc3e_z.jpg",
        "large": "https://farm6.staticflickr.com/5588/14985662396_fcb33afc3e_b.jpg",
        "original": "https://farm6.staticflickr.com/5588/14985662396_undefined_o.jpg"
      }
    }
  ],
  "pageInfo": {
    "totalResults": 1,
    "resultsPerPage": 500
  }
}

參數

GET page=?: 第幾頁 (optional,default:0)
GET page_size=?: 一次顯示幾筆 (optional,default:100,max:500)

相簿照片查詢

給定相簿 ID 之後可以查詢裡面所有相片

GET http://api.kptaipei.tw/v1/albums/[ALBUM_ID]?accessToken=[YOUR_API_KEY]

資料範例：

{
  "isSuccess": true,
  "errorCode": 0,
  "errorMessage": null,
  "data": {
    "set": {
      "id": "72157646239459867",
      "title": "2014.8.20電信工程公會"
    },
    "photos": [
      {
        "id": "14791341020",
        "images": {
          "small": "https://farm6.staticflickr.com/5571/14791341020_3854a614d6_n.jpg",
          "small_square": "https://farm6.staticflickr.com/5571/14791341020_3854a614d6_s.jpg",
          "large_square": "https://farm6.staticflickr.com/5571/14791341020_3854a614d6_q.jpg",
          "thumbnail": "https://farm6.staticflickr.com/5571/14791341020_3854a614d6_t.jpg",
          "medium": "https://farm6.staticflickr.com/5571/14791341020_3854a614d6_z.jpg",
          "large": "https://farm6.staticflickr.com/5571/14791341020_3854a614d6_b.jpg",
          "original": "https://farm6.staticflickr.com/5571/14791341020_493c41de8c_o.jpg"
        },
        "date_upload": 1408525503000,
        "date_taken": 1408517557000,
        "location": {
          "latitude": 0,
          "longitude": 0
        },
        "title": "IMG_3823",
        "isprimary": "0",
        "link": "https://www.flickr.com/photos/110839995@N06/14791341020/in/set-72157646239459867"
      }
    ]
  },
  "pageInfo": {
    "totalResults": 1,
    "resultsPerPage": 500
  }
}

說明

small_square: 75x75 正方形裁切
large_square: 150x150 正方形裁切
thumbnail: 裁切比較長的一邊為 100px
small: 裁切比較長的一邊為 320px
medium: 裁切比較長的一邊為 640px
large: 裁切比較長的一邊為 1024px
original: 原圖大小

參數

GET page=?: 第幾頁 (optional,default:0)
GET page_size=?: 一次顯示幾筆 (optional,default:100,max:500)

影片播放清單查詢

柯文哲有許多影片清單，像是柯P新政等等等，這裡可以取得"播放清單" (playlist)。

GET http://api.kptaipei.tw/v1/videos/?accessToken=[YOUR_API_KEY]

資料範例：

{
  "isSuccess": true,
  "errorCode": 0,
  "errorMessage": null,
  "data": [
    {
      "id": "PLivp01P9aEvZDSf-DNicnXhmJZQPA8rBc",
      "title": "向新世代學習",
      "description": "",
      "publishedAt": "2014-08-16T11:25:34.000Z",
      "thumbnails": {
        "default": {
          "url": "https://i.ytimg.com/vi/YjmkzYpPfTU/default.jpg",
          "width": 120,
          "height": 90
        },
        "medium": {
          "url": "https://i.ytimg.com/vi/YjmkzYpPfTU/mqdefault.jpg",
          "width": 320,
          "height": 180
        },
        "high": {
          "url": "https://i.ytimg.com/vi/YjmkzYpPfTU/hqdefault.jpg",
          "width": 480,
          "height": 360
        },
        "standard": {
          "url": "https://i.ytimg.com/vi/YjmkzYpPfTU/sddefault.jpg",
          "width": 640,
          "height": 480
        },
        "maxres": {
          "url": "https://i.ytimg.com/vi/YjmkzYpPfTU/maxresdefault.jpg",
          "width": 1280,
          "height": 720
        }
      },
      "link": "https://www.youtube.com/playlist?list=PLivp01P9aEvZDSf-DNicnXhmJZQPA8rBc",
      "video_count": 5
    }
  ],
  "pageInfo": {
    "totalResults": 1,
    "resultsPerPage": 100
  }
}

參數

GET page=?: 第幾頁 (optional,default:0)
GET page_size=?: 一次顯示幾筆 (optional,default:100,max:500)

清單內影片查詢

給定清單 id 查閱特定播放清單(playlist) 裡面的影片們。

GET http://api.kptaipei.tw/v1/videos/[PLAYLIST_ID]?accessToken=[YOUR_API_KEY]

資料範例：

{
  "isSuccess": true,
  "errorCode": 0,
  "errorMessage": null,
  "data": [
    {
      "id": "YjmkzYpPfTU",
      "sys_id": "PLpaoUVtD2cSNTIxxkJEdgPeexmJjt4IGN0kBvaQqLkds",
      "title": "【Go! Youth! 做你自己】柯P向新世代學習-預告片",
      "description": "Go! Youth! 做你自己- 柯P向新世代學習系列短片，8/17～8/21，一共五天，每天晚上19:00上線。\n\n柯P官方網站：http://kptaipei.tw/\n柯P粉絲專頁：https://www.facebook.com/DoctorKoWJ",
      "publishedAt": "2014-08-18T10:09:10.000Z",
      "thumbnails": {
        "default": {
          "url": "https://i.ytimg.com/vi/YjmkzYpPfTU/default.jpg",
          "width": 120,
          "height": 90
        },
        "medium": {
          "url": "https://i.ytimg.com/vi/YjmkzYpPfTU/mqdefault.jpg",
          "width": 320,
          "height": 180
        },
        "high": {
          "url": "https://i.ytimg.com/vi/YjmkzYpPfTU/hqdefault.jpg",
          "width": 480,
          "height": 360
        },
        "standard": {
          "url": "https://i.ytimg.com/vi/YjmkzYpPfTU/sddefault.jpg",
          "width": 640,
          "height": 480
        },
        "maxres": {
          "url": "https://i.ytimg.com/vi/YjmkzYpPfTU/maxresdefault.jpg",
          "width": 1280,
          "height": 720
        }
      },
      "link": "https://www.youtube.com/watch?v=YjmkzYpPfTU"
    }
  ],
  "pageInfo": {
    "totalResults": 1,
    "resultsPerPage": 100
  }
}

參數

GET page=?: 第幾頁 (optional,default:0)
GET page_size=?: 一次顯示幾筆 (optional,default:100,max:500)

台北調音樂清單查詢

台北調共計有 82 首歌曲投稿，這裡可以取得"歌曲清單" (playlist)。

GET http://api.kptaipei.tw/v1/musics/?accessToken=[YOUR_API_KEY]

資料範例：

{
  "isSuccess": true,
  "errorCode": 0,
  "errorMessage": null,
  "data": [
    {
      "id": "1",
      "name": "全部歌曲",
      "count": 82
    },
    {
      "id": "2",
      "name": "票選入圍",
      "count": 0
    },
    {
      "id": "3",
      "name": "評審嚴選",
      "count": 0
    }
  ],
  "pageInfo": {
    "totalResults": 3,
    "resultsPerPage": 500
  }
}

參數

GET page=?: 第幾頁 (optional,default:0)
GET page_size=?: 一次顯示幾筆 (optional,default:100,max:500)

台北調播放清單內歌曲查詢

給定清單 id 查閱特定播放清單(playlist) 裡面的音樂們(sound cloud)。要特別注意的是「請只用於播放」，請勿進行各種形式的鼓勵下載檔案、備份或重製，也不能拿來營利。

GET http://api.kptaipei.tw/v1/musics/[PLAYLIST_ID]?accessToken=[YOUR_API_KEY]

資料範例：

{
  "isSuccess": true,
  "errorCode": 0,
  "errorMessage": null,
  "data": [
      {
        "musicID": 48,
        "soundcloudID": "onhdaixllula",
        "votes": "24",
        "song_name": "流水帳進行曲",
        "groupname": "石倍宗",
        "link": null,
        "creative": " ",
        "tags": "華語",
        "track_id": 163687452,
        "waveform_url": "https://w1.sndcdn.com/OhVu2jGhThio_m.png",
        "stream_url": "https://api.soundcloud.com/tracks/163687452/stream?client_id=7d716d401f4d5096ceb5ab87fc0dc217",
        "play_count": 1158,
        "favoritings_count": 0,
        "soundcloud_url": "http://soundcloud.com/kptaipei/onhdaixllula"
      }

  ],
  "pageInfo": {
    "totalResults": 1,
    "resultsPerPage": 150
  }
}

參數

GET page=?: 第幾頁 (optional,default:0)
GET page_size=?: 一次顯示幾筆 (optional,default:100,max:500)

競選經費查詢

主要欄位說明

account : 會計科目
start_date : 開始日期(yyyy/mm/dd) 形式
end_date : 結束日期(yyyy/mm/dd) 形式
start_timestamp : timestamp (毫秒為單位的時間戳記) ，注意是"大於"、不是"超過"
end_timestamp : timestamp (毫秒為單位的時間戳記)，但注意是"未達"、不是"小於"。
label : 詳細內容
price : 金額
type : [income|expense] (收入|支出)
props : 各種類型會計科目的額外資料，像是人事費有銀行名(bank)跟帳戶(account)，政治獻金有匿名與否(anonymous) 跟捐贈人數(counts)，支出費用則有傳票(voucher) 等資料。

GET http://api.kptaipei.tw/v1/financial/all?accessToken=[YOUR_API_KEY]

資料範例：

{
  "isSuccess": true,
  "errorCode": 0,
  "errorMessage": null,
  "data": [
    {
      "account": "網路募款捐贈-匿名",
      "start_date": "2014/4/1",
      "end_date": "2014/4/30",
      "label": "網路募款捐贈-匿名-四月份",
      "props": {
        "anonymous": 1,
        "counts": 0
      },
      "price": 0,
      "type": "income",
      "start_timestamp": 1396281600000,
      "end_timestamp": 1398873600000
    },
    {
      "account": "網路募款捐贈-非匿名",
      "start_date": "2014/4/1",
      "end_date": "2014/4/30",
      "label": "網路募款捐贈-非匿名-四月份",
      "props": {
        "anonymous": 0,
        "counts": 0
      },
      "price": 0,
      "type": "income",
      "start_timestamp": 1396281600000,
      "end_timestamp": 1398873600000
    }
  ]
}

參數

GET page=?: 第幾頁 (optional,default:0)
GET page_size=?: 一次顯示幾筆 (optional,default:100,max:500)

API 說明

API 選單

資料授權條款

文章類別查詢

類別內容查詢

參數

相簿清單查詢

參數

相簿照片查詢

說明

參數

影片播放清單查詢

參數

清單內影片查詢

參數

台北調音樂清單查詢

參數

台北調播放清單內歌曲查詢

參數

競選經費查詢

參數