跳至主要內容

政府資料開放平臺

伍、資料交接作業

一、資料發布至政府資料開放平臺

我有話要說、我想要更多、品質檢測及標準檢測集中至「政府資料開放平臺」僅接受發布(Publish)交換模式類型。發布(Publish)類型為「提供者/平臺」透過「政府資料開放平臺」之資料異動 API,主動將異動(新增)之我有話要說、我想要更多、品質檢測、標準檢測同步至「政府資料開放平臺」。我有話要說、我想要更多、品質檢測、標準檢測交換模式如下表說明:

表 2: 政府資料開放平臺交換模式
類型 交換模式 作法說明
發布(Publish) 即時發布 「提供者/平臺」於我有話要說、我想要更多、品質檢測、標準檢測異動時,立即呼叫「政府資料開放平臺」之異動我有話要說、我想要更多、品質檢測、標準檢測 API,進行異動發布。
定期發布 「提供者/平臺」定期將我有話要說、我想要更多、品質檢測、標準檢測異動部分,呼叫「政府資料開放平臺」之我有話要說、我想要更多、品質檢測、標準檢測 API,進行異動發布。

以下就各交換模式進行說明,「提供者/平臺」可依據實際系統環境需求,選擇 1 種或多種交換模式將資料發布至「政府資料開放平臺」。

1.即時發布模式

「提供者/平臺」於資料異動時,立即呼叫「政府資料開放平臺」的資料異動 API,進行異動發布。「提供者/平臺」即時發布我有話要說、我想要更多、品質檢測、標準檢測流程如下圖所示。


圖 1: 提供者/平臺即時發布我有話要說、我想要更多、品質檢測、標準檢測流程

「提供者/平臺」即時發布我有話要說、我想要更多、品質檢測、標準檢測流程說明如下:

「提供者/平臺」管理者登入「政府資料開放平臺」系統後端管理介面申請跨平臺介接服務,「政府資料開放平臺」管理者審核通過後,設定其資料發布來源 IP,並提供授權 API KEY。

「提供者/平臺」於資料異動後,立即執行發布異動資料。使用授權 API KEY 呼叫「政府資料開放平臺」異動資料 API,進行新增(POST)於「政府資料開放平臺」之我有話要說、我想要更多資料、執行品質檢測、執行標準檢測。

紀錄發布回傳結果,若有錯誤訊息,請參考錯誤處理程序,並於錯誤排除後進行重新發布。

2.定期發布模式

「提供者/平臺」定期檢查我有話要說、我想要更多、品質檢測、標準檢測異動狀況,發現有異動時,呼叫政府資料開放平臺之資料異動 API,進行異動發布。「提供者/平臺」定期發布我有話要說、我想要更多、品質檢測、標準檢測流程如下圖所示。


圖 2: 提供者/平臺定期發布我有話要說、我想要更多、品質檢測、標準檢測流程

「提供者/平臺」定期發布我有話要說、我想要更多、品質檢測、標準檢測流程說明如下:

(1)「提供者/平臺」管理者登入「政府資料開放平臺」系統後端管理介面申請跨平臺介接服務,「政府資料開放平臺」管理者審核通過後,設定其資料發布來源 IP,並提供授權 API KEY。

(2)「提供者/平臺」設定定期發布時間,並於執行發布我有話要說、我想要更多、品質檢測、標準檢測時。使用授權 API KEY 呼叫「政府資料開放平臺」異動資料 API,進行新增(POST)於「政府資料開放平臺」之我有話要說、我想要更多資料、執行品質檢測、執行標準檢測。

(3)紀錄發布回傳結果,若有錯誤必須參考錯誤處理程序,並於錯誤排除後進行重新發布。

二、資料交換方式

資料的發布方式採用 RESTFul 網路服務呼叫方式,以 HTTP POST 呼叫新增我有話要說、我想要更多資料、執行品質檢測、執行標準檢測。因使用 HTTP 基本認證方式,需有授權之 API KEY,故需採用含有安全性傳輸的 HTTPS 方式進行資料傳輸。取得我有話要說、我想要更多資料、品質檢測結果、標準檢測結果之呼叫 API 擷取方式必須以 HTTP GET 的方式呼叫。

三、資料內容格式

資料之內容格式必須遵循「我有話要說、我想要更多、品質檢測、標準檢測之介接指引」,資料輸出及回傳皆為 JSON 格式。