News for hackers. Stuff that matters.
Re:Your API is not RESTful by nubela on Wednesday August 08, 2012 @01:49PM (#4356910)
erm, "Instead you probably want to POST data to the /users collection."

wouldn't it be PUT?

Re:Your API is not RESTful by kodablah on Wednesday August 08, 2012 @02:52PM (#4357346)
I believe post is for creating with posted value(s). Put would be just a modification without posted value. E.g. "PUT /users/123/disabled" would disable a user.

Edit: after reading, POST is for creating with an unknown identifier (think INSERT w/ auto-generated PK) whereas PUT is for creating or updating (if already present) with a known identifier (think UPSERT w/ a manually entered PK).

Re:Your API is not RESTful by tobiassjosten on Thursday August 09, 2012 @04:10AM (#4360088)
You could set it up to either accept clients to POST a user to the /users collection, or PUT a user at /users/123. With unknown IDs the latter isn't really viable.

This is primarily a matter of idempotence. Several POSTs to /users would create many identical users whereas multiple PUTs to /users/123 would have exactly the same result as just one request. The PUT is idempotent.