Pfthb

I have an API method with this signature:

public async Task<IActionResult> PostCompanies([FromBody] List<Company> companies)

...and the auto generated swagger docs show that the JSON should be a plain array:

 [ 
 
 "fuelSiteId":228972,
 "name": "foo"
 ,
 
 "fuelSiteId":300000010,
 "name": "bar"
 
 ]

However, if I post this back, it doesn't work and I get the error:

"Cannot deserialize the current JSON array (e.g. [1,2,3]) into type 'Company' because the type requires a JSON object"

The fix is to add the array to a dummy property:

 
 data: [
 
 "fuelSiteId":228972,
 "name": "foo"
 ,
 
 "fuelSiteId":300000010,
 "name": "bar"
 
 ]

But everything I'm finding on this site implies this shouldn't be necessary and isn't how you'd normally do it in REST. Additionally, it means what the auto-generated docs say isn't actually what should be posted!

Which is wrong? My API code or the auto-gen Swagger docs or something else?

Ideally I would prefer my API to accept the 'plain' version as this seems more standard and more natural.

This also works without having to wrap in another type, give it a try.
I've tested with Postman

 [HttpPost]
 public JsonResult InsertPatientAppointment([FromBody] List<Company> companies)
 
 return new JsonResult(companies.Select(c =>
 new
 
 c.FuelSiteId,
 c.Name,
 
 ));
 

 public class Company
 
 [JsonProperty("fuelSiteId")]
 public int FuelSiteId
 
 get;
 set;
 
 [JsonProperty("name")]
 public string Name
 
 get;
 set;
 
 

You can also check other resource on SO how to post json object array to a web api I had to dig a bit myself as I didn't remember anymore how to do this..

As stated at Parameter Binding in ASP.NET Web API: "To force Web API to read a complex type from the URI, add the [FromUri] attribute to the parameter."

Using [FromBody]