URI命名原則

開放資料可透過URL方式取得資料。

Web API （application programming interface）表現方式：

分為網站根目錄（App Root）、資源路徑（Resource Path）和查詢選項（Query Options）

• 網站根目錄：應用服務的基本網址，主要組成為（Domain）網域名稱和（App）應用程式名稱，並且透過 HTTP 協定連結而形成服務的基本網址。

  Domain: ptx.transportdata.tw

  App : MOTC或PTX

• 資源路徑：指定資源項目路徑名稱。

目錄結構	意義
Version(版本)	提供服務的版本號。目前提供 v2、v3(第二、三版)，若沒輸入則預設最新版本
Service(服務)	依據載具本身提供的服務，例如： 鐵道：台鐵(TRA)、高鐵(THSRC) 空運：航空(Aviation) 道路：公車(Bus)等
Application(應用內容)	根據每個服務而提不同的應用內容，例如： 航空：航班資訊(FIDS)和機場資訊(Airport)

各運具API URI設計

• 航空API URI規則：ptx.transportdata.tw/MOTC/v2/Air/{Data}

• 市區公車API URI規則：ptx.transportdata.tw/MOTC/v2/Bus/{Data}/City/{City}/{RouteName}

• 公路客運API URI規則：ptx.transportdata.tw/MOTC/v2/Bus/{Data}/InterCity/{RouteName}

• 軌道API URI規則：ptx.transportdata.tw/MOTC/v2/Rail/{Operator}/{Data}

  • {Operator}：TRA: 台鐵; THSR: 高鐵

• 捷運API URI規則：ptx.transportdata.tw/MOTC/v2/Rail/Metro/{Data}/{Operator}

  • {Operator}：TRTC: 北捷; KRTC: 高捷;TYTC: 桃捷

• 自行車API URI規則：ptx.transportdata.tw/MOTC/v2/Bike/{Data}/{City}

※上述連結需套用所需查詢之Data資料類型、業管機關、城市或路線。

PTX API URI說明文件詳見連結請詳見以下連結

http://ptx.transportdata.tw/ptx/Download/API_URI_Convention文件_v1.pdf