什么时候应该在REST服务的POST请求中使用json主体？

Question

When should one use JSON body in a POST in REST service?

How many parameters / arguments would one start considering json body?

I have a case here where I would like to POST a request to a server with a list of subscription toggled explicityly.

The following is what I came up with a POST request body. But should I also consider using url arguments for factory_id?

{
  "data": [
    {
      "is_subscribed": false,
      "game_id": 0
    },
    {
      "game_id": 1,
      "is_subscribed": true
    }
  ],
  "factory_id": 3
}

Thanks!

Answer 1

I think it depends on the agreement between server and client side on the protocol used to exchange data, it can be JSON, XML and others. I don't think it's a good idea to exchange data using URL , since you can't transfer binary data in this way and it introduces overhead to server for parsing and assembling the message.