API 認證資訊

一、會員註冊取得API Key

1.本平臺提供透過 API 取用資料，惟因本平臺採用會員服務機制，需帶入由會員透過API認證ID和API認證密碼，取得Access Token，方可取得各式開放資料。

2.於 會員註冊 後，註冊並驗證信箱成功後，平台將會自動申請一組API認證ID，與API認證密碼，用此認證ID與認證密碼產生Access Token。

3.登入會員後，到[會員專區]>[API認證資訊]，按照操作方式可於線上取得Access Token，或者透過工具(如PostMan)獲取Access Token。

二、以「API 線上文件」存取資料，供應用程式介接

1.線上取得Access Token

步驟一.至[會員專區]>[API認證資訊]，點擊[取得Token]，可於線上取得一組使用期限為30分鐘的Access Token。

步驟二.複製紅色框框內的文字。

2.至「API 線上文件」取得 API URL

步驟一：至[開發指引]>[API 線上文件]，點擊右上角紅色框框的[Authorize]按鈕，準備輸入1.步驟二所複製的文字。

步驟二：在紅色框框中，輸入Bearer與一個空格，如"Bearer "與1.步驟二所複製的文字。

步驟三：然後點擊下方的[Authorize]，再按[Close]，即可套用Access Token

步驟四：每個資料集 API 各有其可運用的參數，以「​/uswg​/stations 路面淹水感知器」資料集為例，點擊「Try it out」，可使用以下圖之七項參數，填入參數後，點擊「Execute」

步驟五：下圖為回傳的畫面

3.API 參數說明

以「​/uswg​/stations 路面淹水感知器」資料集為例，API URL 格式如下:

https://iot.wra.gov.tw/uswg/stations?countyCode={countyCode}&countyName={countyName}&townCode={townCode}&townName={townName}&centerLat={centerLat}&centerLong={centerLong}&radius={radius}

回傳的格式範例如下: