回首頁回首頁 > 開發指南

開發指南

一、說明

立法院開放資料服務平台提供各式立法院資訊,提供民眾或院外單位進行下載或透過API方式進行介接,以進行加值應用程式之開發。

本平台採取較普及之資料交換格式以進行資料交換,包含XLS、CSV、TXT、XML及JSON,每份資料將以二維陣列的方式呈現資料內容,開發人員可透過資料集之詳細說明,了解資料集間之關聯性。

二、流程

欲進行立法院開放資料介接有以下步驟:

1. 選定資料集

使用者可透過資料搜尋或者資料目錄的方式,查詢所需要的資料集,並透過資料集描述確認內容,包含資料集說明、欄位說明、更新頻率、資料筆數及更新時間等資訊。

2. 確認格式

使用者可透過資料集描述之資料集預覽確認資料集樣式,並透過資料集使用,選定介接格式。

3. 撰寫介接程式

詳細資料集樣式及格式清單可參考資料集描述之使用方式及清單,撰寫程式特別注意如下:

(1) JSON規則

http://data.ly.gov.tw/ODM_FT/openDatasetJson.action?id=<資料集序號>&selectTerm=<屆期別>&page=<頁碼>

資料集序號:資料集實際使用的關鍵值

屆期:all:全部 , 0801:第八屆第一期, 0802:第八屆第二期, 以此類推(本平台提供第八屆第一期起之資料)

頁碼:每頁提供1000筆資料

(2) XML規則

http://data.ly.gov.tw/ODM_FT/openDatasetXml.action?id=<資料集序號>&selectTerm=<屆期別>&page=<頁碼>

資料集序號:資料集實際使用的關鍵值

屆期:all:全部 , 0801:第八屆第一期, 0802:第八屆第二期, 以此類推(本平台提供第八屆第一期起之資料)

頁碼:每頁提供1000筆資料

(3) CSV、TXT、XLS規則

CSV、TXT、XLS為檔案格式,資料集描述之使用方式及列表將會詳細列出所有的檔案清單,其格式如下:

http://data.ly.gov.tw/ODM_FT/<資料集序號>_<格式代碼>/<資料集序號>_<屆期>CSV-<頁碼>.csv

資料集序號:資料集實際使用的關鍵值

格式代碼:如CSV、TXT、XLS

屆期:all:全部 , 0801:第八屆第一期, 0802:第八屆第二期, 以此類推(本平台提供第八屆第一期起之資料)

三、自造字說明

針對自造字問題,因大部分的程式語言針對轉譯字符的設定預設是關閉的,故開發人員只要將設定打開即可。如Java中使用escapeXml=“false”啟動轉譯字符設定,網頁則會正常顯示。

四、應用範例

實際應用範例可參考法案審議訂閱。

電腦版