Node.JS學習筆記(九)_Restful API的swagger文檔_304 not modified狀態碼異常_ETag介紹
後端寫好的API之後前端要如何知道有哪些路由可以存取? 因此Swagger 文檔這套API文件生成工具就可方便讓我們提供給前端參考。 Swagger 強大的地方在於,只需要寫一個 json 檔,就可以動產生出 API document 在網頁上瀏覽,還可以直接發送 http request 來測試 API。 以Foreca 此網站來看,就有提供 API 供開發者串接, 所以 API document 就需要十分清楚透明 https://developer.foreca.com/#Forecasts 新建一個NodeJs Express專案 我們這裡的進入點是index.js cd. > index.js npm install express npm install nodemon 多下載此套件來直接將我們的 json 轉換為 API document npm install swagger-ui-express code1: 1 2 3 4 5 6 7 8 const express = require( "express" ); const app = express(); const PORT = 3000 ; app.listen(PORT,()=>{ console.log( 'Server is listen on port ' + PORT); }); 那預設express專案配置起來會預設安置好的port -> 3000,這裡是可自行定義的。 就類似對應的鑰匙門房號或是密鑰,知道正確結果的就可以進行存取。 那port 連接埠、協定埠 (protocol port)就好比如電腦的各式各樣服務的門,也是一種識別應用服務的代號,範圍從0~65535。 但預設有已經有相應功能的port 以下的就要避免用到專用port 80: HTTP服務 443:HTTPS服務 21:FTP服務 23:SSH服務 3306:MySQL預設port (若有兩個以上會額外定義) 27017:MongoDB預設port(若有兩個以上會額外定義) 編寫get請求方法 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 const express = requir