From commits-return-1529-apmail-couchdb-commits-archive=couchdb.apache.org@couchdb.apache.org Sat Dec 20 10:21:09 2008 Return-Path: Delivered-To: apmail-couchdb-commits-archive@www.apache.org Received: (qmail 81691 invoked from network); 20 Dec 2008 10:21:09 -0000 Received: from hermes.apache.org (HELO mail.apache.org) (140.211.11.2) by minotaur.apache.org with SMTP; 20 Dec 2008 10:21:09 -0000 Received: (qmail 33457 invoked by uid 500); 20 Dec 2008 10:21:09 -0000 Delivered-To: apmail-couchdb-commits-archive@couchdb.apache.org Received: (qmail 33431 invoked by uid 500); 20 Dec 2008 10:21:09 -0000 Mailing-List: contact commits-help@couchdb.apache.org; run by ezmlm Precedence: bulk List-Help: List-Unsubscribe: List-Post: List-Id: Reply-To: dev@couchdb.apache.org Delivered-To: mailing list commits@couchdb.apache.org Received: (qmail 33422 invoked by uid 500); 20 Dec 2008 10:21:09 -0000 Delivered-To: apmail-incubator-couchdb-commits@incubator.apache.org Received: (qmail 33419 invoked by uid 99); 20 Dec 2008 10:21:09 -0000 Received: from nike.apache.org (HELO nike.apache.org) (192.87.106.230) by apache.org (qpsmtpd/0.29) with ESMTP; Sat, 20 Dec 2008 02:21:09 -0800 X-ASF-Spam-Status: No, hits=-2000.0 required=10.0 tests=ALL_TRUSTED X-Spam-Check-By: apache.org Received: from [140.211.11.130] (HELO eos.apache.org) (140.211.11.130) by apache.org (qpsmtpd/0.29) with ESMTP; Sat, 20 Dec 2008 10:21:07 +0000 Received: from eos.apache.org (localhost [127.0.0.1]) by eos.apache.org (Postfix) with ESMTP id 7BFBA118DB for ; Sat, 20 Dec 2008 10:20:46 +0000 (GMT) Content-Type: text/plain; charset="us-ascii" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit From: Apache Wiki To: couchdb-commits@incubator.apache.org Date: Sat, 20 Dec 2008 10:20:46 -0000 Message-ID: <20081220102046.16474.94469@eos.apache.org> Subject: [Couchdb Wiki] Update of "HTTP Document API" by JanLehnardt X-Virus-Checked: Checked by ClamAV on apache.org 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.