POST array of objects to REST API

Question

I\'m designing REST API that should be able to accept array of objects, say

[
 {
   \'name\': \'Alice\',
   \'age\': 15
 },
 {
   \'name\': \'Bob\',
   \'age         


        

Answer 1

Basically, the answer I was looking for was:

1. There is no need to use Content-Type: application/x-www-form-urlencoded which is standard in web; instead, Content-Type: application/json should be used,

2. The whole HTTP request then looks as follows:

   POST /whatever HTTP/1.1
   Host: api.example.com
   Content-Type: application/json
   
   [
     {
       'name': 'Alice',
       'age': 15
     },
     {
       'name': 'Bob',
       'age': 20
     },
     ...
   ]
   

Answer 2

There is no need to wrap the array in another object with a data property. The array by itself is valid JSON:

post_params = JSON.stringify([ { 'name' : 'Alice', 'age' : 15 },
                               { 'name' : 'Bob',   'age' : 20 },
                                  ...
                             ]);
post(url, post_params);

Just make sure your API expects this array as well.