asp.net core web api model naming rule coding style appsettings visual studio code restful api

ASP.NET Core 5 EP 10:第一支HTTP POST API

開發HTTP Post API

步驟1:在Controller/RecipeController.cs檔案中,新增一個POST方法的API函數。

// 設定這個API使用POST方法
[HttpPost]
// 接受以Json格式的資料,並且放置於HTTP Body傳送進來
public IActionResult Post([FromBody] Models.Resipe objResipe)
{
    // 檢查傳進來的資料Model是否符合所定義的規格
    if (ModelState.IsValid)
    {
        // 不做任何處理,直接回傳給客戶端
        return Ok(objResipe);
    }
    else
    {
        // 資料規格不符,回傳HTTP 400
        return BadRequest();
    }
}

步驟2:使用指令啟動ASP.NET Core Web API服務:

$ dotnet build
$dotnet run

步驟3:連到Swagger (預設網址為https://localhost:5001/swagger/index.html),可以看到畫面中有兩支API,其中一支就是剛剛新增的POST方法API,並且提供輸入資料的規格。

swagger http post api

到此,我們已經會開發最基本的API了,但還有許多細節,慢慢的在後續與大家分享,每一篇的內容不寫太多,讓新手照著做,時間不至於太攏長,也比較會有成就感!

~ END ~


, , ,

Related posts

Latest posts