為使任一資料開放平臺之資料集詮釋資料可同步至政府資料開放平臺,故訂定政府資料開放跨平臺介接同步模式及流程,提供跨平臺統一的依循架構和原則。各資料平臺申請與本平臺之介接將採取「機關發佈publish」機制為主。若產生介接異常錯誤訊息,請依據下列錯誤訊息代碼執行錯誤排除。
-
錯誤訊息代碼一覽表
| 錯誤代碼 | 訊息內容 |
| ER0000 | 系統例外 |
| ER0001 | API KEY 錯誤 |
| ER0002 | 來源IP不允許 |
| ER0003 | JSON格式錯誤 |
| ER0020 | 必填欄位未填 |
| ER0030 | 欄位資料型態錯誤 |
| ER0031 | 資料集服務分類錯誤 |
| ER0032 | 資料集主題分類錯誤 |
| ER0034 | 資料集授權方式錯誤 |
| ER0037 | 檢測頻率不存在/平臺無此類檢測頻率 |
| ER0042 | 資料集提供機關錯誤/提供機關物件識別碼不存在 |
| ER0051 | 欲修改的資料集不存在 |
| ER0060 | 欲刪除的資料集不存在 |
| ER0071 | 欲新增的資料集已存在/資料集名稱重複 |
| ER0076 | 資料集描述不得與資料集名稱相同 |
跨平臺介接申請服務申請通過後,由後臺管理者提供ㄧ組API KEY作為資料集新增、修改、下架時的身分認證。API KEY採用UUID方式建立,格式如550e8400-e29b-41d4-a716-446655440000。HTTP header 裡設定屬性Authorization的值為API Key,若顯示該錯誤訊息請與維運團隊聯繫,發送信件至[email protected]。
來源IP為機關申請跨平臺介接服務,所提供之機關IP,可提供多組。請確認提供IP是否相符,如有異動請登入後臺進行跨平臺介接服務申請與異動。
請參閱本平臺M2M專區-政府資料開放跨平臺介接規範<機關發布開發指引>,提供JSON同步機制範例。
JSON必填欄位未填,於message中顯示未填的必填欄位名稱。
欄位資料型態錯誤,於message中顯示錯誤的欄位名稱與內容。
資料集服務分類編碼輸入錯誤,本平臺「服務分類」依據民眾所熟悉之方式提供檢索服務;共計18個分類項目,類別及編碼為「生育保健」(100)、「出生及收養」(200)、「求學及進修」(300)、「服兵役」(400)、「求職及就業」(500)、「開創事業」(600)、「婚姻」(700)、「投資理財」(800)、「休閒旅遊」(900)、「交通及通訊」(A00)、「就醫」(B00)、「購屋及遷徙」(C00)、「選舉及投票」(D00)、「生活安全及品質」(E00)、「退休」(F00)、「老年安養」(G00)、「生命禮儀」(H00)、「公共資訊」(I00)。(有關服務分類訂定原則及本分類詳細辭彙代碼,請至下列網址 https://www.gsp.gov.tw/category-data.htm 下載者為準)。
跨平臺介接機關依據資料集識別碼(datasetId)修改資料集,其欲修改資料集不存在於本平臺。
跨平臺介接機關依據資料集識別碼(datasetId)刪除資料集,其欲刪除資料集不存在於本平臺。
本平臺同一機關單位不得同時存在相同資料集名稱,請修改資料集之名稱。

