跳到主要內容區塊

關於我們

開放資料專區

:::

通用說明

「國家文化記憶庫」資料開放政策說明
文化開放,全民共享!文化部(以下簡稱:本部)為響應「開放政府」思維,配合國發會「政府資料開放」政策,積極推動文化開放資料(Open Data)。本網站豐富的文化素材,只要是依PDM、CC0、OGDL上述3款公眾宣告或授權標示,即為本網站開放資料的範圍,可依其規範直接下載使用,不需另外申請、付費。
另為擴大推廣重點文化開放資料,本部參考國發會所制定之「政府資料開放進階行動方案」,將彙整發布開放原始資料(Raw Data)之資料集(Dataset)讓民眾下載,同時也提供開放應用程式介面(Application Program Interface, API)服務,讓各界應用資料的方式更為便利。
開放資料集OPEN DATA SET
本網站將比照本部文化資料開放服務網,彙整站內重要文化素材之詮釋資料內容,主動發布為開放資料集,提供格式為JSON檔;另考量本網站屬portal入口網,目前所介接之「資料來源機關」大部分均已於原網站各別發布其開放資料集,為避免資源重複提供,因此本網站開放資料範圍係以本部「國家文化記憶庫收存系統」之數位物件檔案類型為「圖像類」為限。另鑒於本網站資料來源為跨機關單位所提供,每種素材的詮釋資料屬性欄位不一,因此開放資料集的欄位僅限共通性欄位。
OPEN API
另為方便各界加值應用,如需各種素材來源端所提供的客製化欄位,請透過OPEN API服務取得相關資料。使用本項服務請先進行API key申請,經本部審核通過後,將以e-mail通知。
本網站所提供之RESTful Web API,使用者可採用HTTP GET方法,取得本網站之開放資料,並以JSON 檔回傳結果。
每一次叫用API服務時,其驗證碼需於HTTP Header中傳遞,變數名稱為 apiKey,apiKey之數值為申請後所得之驗證碼,apiKey之格式範例為:6fc459ea-ee9a-3ca4-8e43-db77e1603333。
名詞定義
{SRU}:API服務之根網址
https://memory.culture.tw/openapi/api/
服務結構範例
https://memory.culture.tw/openapi/api/v1/search?keyWord=&pageSize=1&atPage=0&apiKey=98f6f0d4ae304783b74662416008a18e25afde3be5a64d7d&source=Culture_Event&subject=societ
{SRU}: https://memory.culture.tw/openapi/api/
服務路徑:https://memory.culture.tw/openapi/api/v1/search?
輸入參數:?Keyword=眷村&PageSize=10
資料回傳結構
{
  "Error": false,
  "Message": null,
  "JsonData": {
    "TotalQuerySecond": "0.1875018",
    "TotalDocNo": 2104,
    "ResultData": [
      {
        "Id": "135107",
        "Title": "回顧與前瞻1.1--從縣綜合計畫",
        "ImageUrl":"https://cmsfile.culture.tw/ c84fc.gif",
        "IndexCode": "Culture_Event",
        "Description": "nn本場為宜蘭空間三十第一次座談會",
        "Rights": "CC BY",
        "Des_Rights": "CC BY",
        "Longitude": "121.8327529",
        "Latitude": "24.8686566",
        "Original_Url":"https://cmsdb.culture.tw/event/F8266",
        "Original_Identifier": "135107",
        "Subject": "空間、地域與遷徙",
        "alias": "",
        "Keywords": "宜蘭@#@宜蘭空間@#@宜蘭經驗",
        "startDate": "2016/11/04",
        "endDate": "2016/11/04",
        "LastUpdateTime": "2020/09/11 14:18:56",
        "timelines": "",
        "place": "",
        "city": "",
        "address": "青雲路三段750號",
        "sameAs": "",
        "organizer": "宜蘭縣立蘭陽博物館",
        "contributors": "",
        "contributor": "蔡聰琪(主講人);蘇美如等(文字整理)",
        "eventUrl": "",
        "performers": "",
        "lengthOfTime": "",
        "createOrgName": "管理單位",
        "dataSource": "",
        "workFeatured": "",
        "AllImages": "https://cmsfile.culture.tw/xxxxxx.jpg"
      }
    ]
  }
}
Message錯誤訊息,若沒有錯誤,回傳null
JsonData回傳服務結果
error若沒有錯誤,回傳false