Rest API用于POST和GET / PUT的不同模型

Question

I am designing a REST API. As you know there is no real specification for a RESTful API. In my case i have a simple API where i have users. I can get users, update them. Something like this:

GET .../users/12

However for creating users i want the only to allow a subset of the properties. Eg When you get a user, you get many properties like: Id, Name, CreationDate and so on

When you create a user i only want to allow to POST the Name and nothing else. Is it allowed to have different models for different http verbs for the same resource in your understanding of a RESTful service? Or would you expect that a

POST ../users

can have exactly the same properties as you get when you fetch an existing one?

Or is there something you think i should not do this? Just wondering after reading many religious discussions ;)

Thank you in advance best Laurin

Answer 1

First: I think there is a good definition of the RESTful architecture style in Roy Fieldings dissertation Architectural Styles and the Design of Network-based Software Architectures .

Second: I think you have a small misunderstanding REST is not about models or controllers it is about resources. Often there is a one-to-one relation between model and resource but it is not required.

Third: To realize your requirements you only need one user model. When the API user posts more than your allowed parameters just ignore them and use only the parameters you want to set on your newly created model. Or if you don't want to ignore them return a 400 Bad Request HTTP status.