Minimal API memetakan sebuah rute ke handler, sering kali berupa lambda: app.MapGet("/products/{id:int}", (int id, IProductStore store) => ...). ASP.NET Core mengisi parameter handler untuk Anda: parameter yang namanya sama dengan nilai rute ({id}) akan menerimanya, tipe sederhana yang tidak ada di rute berasal dari query string (?page=2), service yang terdaftar berasal dari dependency injection, dan tipe kompleks pada POST berasal dari body JSON. Route constraint seperti {id:int} membuat /products/abc tidak cocok dengan rute mana pun.
Handler mengembalikan data (dikirim sebagai JSON dengan status 200) atau IResult yang menetapkan status: Results.Ok(product), Results.NotFound(), Results.Created($"/products/{id}", product) dengan header Location, Results.Conflict(), Results.BadRequest(), dan Results.ValidationProblem(errors) untuk respons 400 dengan pesan per kolom. Menetapkan status yang benar adalah bagian dari kontrak API: klien menentukan tindakannya berdasarkan status tersebut.
Input divalidasi sebelum digunakan. Data annotation seperti [Required] dan [Range] (dari System.ComponentModel.DataAnnotations) menjelaskan aturannya, dan Validator.TryValidateObject memeriksanya.
Tentang kode di sini: ASP.NET Core tidak berjalan di runtime browser ini, jadi latihan-latihan ini memakai pengganti sederhana untuk host ASP.NET Core, dengan nama yang sama dan aturan yang sama untuk hal-hal yang diperiksa pelajaran ini. Ini adalah penyederhanaan: tidak ada server HTTP maupun middleware. app.SendAsync(method, url, body) berperan sebagai klien, JSON memakai nama camelCase yang sama, dan atribut bergaya [FromBody] tidak diperlukan dan tidak didukung. Data annotation-nya adalah yang asli.
Satu GET dengan nilai rute dan satu POST dengan body JSON, masing-masing mengembalikan kode status tertentu.