You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@couchdb.apache.org by Apache Wiki <wi...@apache.org> on 2009/03/31 22:36:20 UTC

[Couchdb Wiki] Trivial Update of "HTTP Document API" by RyanFunduk

Dear Wiki user,

You have subscribed to a wiki page or wiki category on "Couchdb Wiki" for change notification.

The following page has been changed by RyanFunduk:
http://wiki.apache.org/couchdb/HTTP_Document_API

The comment on the change is:
/_uuids is accessed via GET, not POST

------------------------------------------------------------------------------
  
  === POST ===
  
- The ''POST'' operation can be used to create a new document with a server generated DocID. To create a named document, use the ''PUT'' method instead. It is recommended that you avoid ''POST'' when possible, because proxies and other network intermediaries will occasionally resend ''POST'' requests, which can result in duplicate document creation. If your client software is not capable of guaranteeing uniqueness of generated UUIDs, use a ''POST'' to ''/_uuids?limit=100'' to retrieve a list of document IDs for future ''PUT'' requests. Please note that the ''/_uuids''-call does not check for existing document ids; collision-detection happens when you are trying to save a document.
+ The ''POST'' operation can be used to create a new document with a server generated DocID. To create a named document, use the ''PUT'' method instead. It is recommended that you avoid ''POST'' when possible, because proxies and other network intermediaries will occasionally resend ''POST'' requests, which can result in duplicate document creation. If your client software is not capable of guaranteeing uniqueness of generated UUIDs, use a ''GET'' to ''/_uuids?limit=100'' to retrieve a list of document IDs for future ''PUT'' requests. Please note that the ''/_uuids''-call does not check for existing document ids; collision-detection happens when you are trying to save a document.
  
  The following is an example HTTP ''POST''. It will cause the CouchDB server to generate a new DocID and revision ID and save the document with it.