What's the purpose of HTTP PUT?

Question

Why do we have method 'PUT' in AJAX and where is it most used?

Example:

$.ajax({
    url: 'script.php',
    type: 'PUT',
    success: function(response) {
        //...
    }
});

Why didn't the author simply use GET/POST instead?

http://en.wikipedia.org/wiki/Representational_state_transfer#RESTful_web_APIs — zerkms, Sep 15 '13 at 11:29
See http://stackoverflow.com/questions/630453/put-vs-post-in-rest — Laimoncijus, Sep 15 '13 at 11:30

ThiefMaster · Accepted Answer · 2013-09-15T11:35:19.553

For RESTful APIs POST has a specific meaning (create a resource) while PUT has a different one (update an existing resource):

GET retrieves a list or an item
PUT replaces a collection or an item
POST creates a new item in a collection
DELETE deletes a collection or an item

However, if there's really "script.php" whoever developed it was not very thorough when creating his API. "script.php" is pretty much not RESTful at all... Usually the URL structure of a proper RESTful API looks e.g. like this:

http://example.com/questions would be a collection (GET to list, PUT to replace all items, POST to create a new item, DELETE to delete all items)
http://example.com/questions/123 would be an item (GET to retrieve, PUT to replace, POST usually unused, DELETE to delete that item)

What's the purpose of HTTP PUT?

1 Answers1