跳到主要內容區塊

關於我們

開放資料專區

API Key 申請 開放資料集
:::

通用說明

「國家文化記憶庫」資料開放政策說明
文化開放，全民共享！文化部（以下簡稱:本部）為響應「開放政府」思維，配合國發會「政府資料開放」政策，積極推動文化開放資料（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=society
{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