7.取得資料集之資料資源內容
一、使用說明:
使用API取得平臺上符合條件之資料資源內容
二、介接網址:
http://data.tycg.gov.tw/api/v1/rest/datastore/{resource ID}?q={q}&sort={sort}&limit={limit}&offset={offset}
{resource ID}:資料資源編號。
{q}:資料資源所有內容之全文檢索字串。
{sort}:排序資料資源之欄位名稱。可多欄位排序,使用半形逗號「,」隔開,範例:sort=EngFiled1,EngFiled2。可遞增或遞減排序,使用空白隔開,範例:sort=EngFiled1 desc,EngFiled2 asc
{limit}:預設API回傳100筆資料,可經由本參數指定最多回傳的資料筆數。
{offset}:指定從第幾筆後開始回傳, 可與limit配合使用達到分頁目的。預設值: 0。
- 三、輸入範例:
範例:http://data.tycg.gov.tw/api/v1/rest/datastore/b6c7cec3-3d73-478b-8197-276eef534a80
輸出:
四、檔案格式:JSON
五、備註:
資料資源編碼{resource ID}為各資料資源之識別碼。一個資料集可有多個資料資源,各個資料資源只有一個資料資源編碼。
{resource ID}為必填的路徑名稱,參數則為選擇性填寫。
資料資源內容可連結至一般檔案或資料庫表格,此API為取得資料庫表格內容,並非取得一般檔案。
查詢結果失敗將回傳錯誤代碼,如下:
錯誤代碼 | 訊息內容 | 說明 |
---|---|---|
ER0100 | 找不到Resource資料。 | 找不到指定的resourceID資料內容。 |
ER0200 | 輸入的參數名稱錯誤。 | 輸入的參數名稱不在規範中。 |
ER0210 | 輸入的參數內容格式錯誤。 | 輸入的參數內容格式有錯誤。 |
ER0220 | 輸入的參數內容中,欄位名稱不存在。 | 在輸入參數sort、fields的內容中,所指定欄位名稱不存在。 |
ER0500 | 系統錯誤。 | 其他系統錯誤。 |