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 2011/11/23 13:26:34 UTC

[Couchdb Wiki] Update of "HTTP_Document_API" by RobertNewson

Dear Wiki user,

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

The "HTTP_Document_API" page has been changed by RobertNewson:
http://wiki.apache.org/couchdb/HTTP_Document_API?action=diff&rev1=79&rev2=80

Comment:
Remove mention of _all_docs_by_seq (obsolete)

  }}}
  If you add ''include_docs=true'' to a request to ''_all_docs'' not only metadata but also the documents themselves are returned.
  
+ === _changes ===
- === all_docs_by_seq ===
- NOTE: See [[HTTP_database_API#Changes|/database/_changes]] as of 0.11
  
  This allows you to see all the documents that were updated and deleted, in the order these actions are done:
  
  {{{
- GET somedatabase/_all_docs_by_seq HTTP/1.0
+ GET somedatabase/_changes HTTP/1.0
  }}}
  Will return:
  
@@ -433, +432 @@

    ]
  }
  }}}
- All the view parameters work on _all_docs_by_seq, such as startkey, include_docs etc. However, note that the startkey is exclusive when applied to this view. This allows for a usage pattern where the startkey is set to the sequence id of the last doc returned by the previous query. As the startkey is exclusive, the same document won't be processed twice.
+ All the view parameters work on _changes, such as startkey, include_docs etc. However, note that the startkey is exclusive when applied to this view. This allows for a usage pattern where the startkey is set to the sequence id of the last doc returned by the previous query. As the startkey is exclusive, the same document won't be processed twice.
+ 
+ See [[HTTP_database_API#Changes|/database/_changes]] for more details.
  
  == Attachments ==
  Documents can have attachments just like email. There are two ways to use attachments. The first one is inline with your document and it described first. The second one is a separate REST API for attachments that is described a little further down.