couchdb-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From Apache Wiki <wikidi...@apache.org>
Subject [Couchdb Wiki] Update of "HTTP Document API" by JanLehnardt
Date Sat, 20 Dec 2008 10:20:46 GMT
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 JanLehnardt:
http://wiki.apache.org/couchdb/HTTP_Document_API

The comment on the change is:
UUIDs are not crypto-secure, just guaranteed to be unique

------------------------------------------------------------------------------
  
  === 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 generating cryptographically secure UUIDs, use a ''POST'' to ''/_uuids?count=100''
to retrieve a list of unused document IDs for future ''PUT'' requests.
+ 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?count=100''
to retrieve a list of unused document IDs for future ''PUT'' requests.
  
  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.
  

Mime
View raw message