Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
Next revision
Previous revision
Next revision Both sides next revision
dev:web_api:v2:changes_from_v1 [2013/02/12 19:47]
dstillman
dev:web_api:v2:changes_from_v1 [2014/06/05 15:43]
dstillman "Server API" -> "Web API"
Line 1: Line 1:
 ====== Changes from API Version 1 ====== ====== Changes from API Version 1 ======
  
-As [[https://​groups.google.com/​d/​msg/​zotero-dev/​egIdfVmWEeo/​dkOfupK7EXoJ|announced on zotero-dev]],​ version 2 of the [[start|Zotero ​Server ​API]] brings many changes to enable [[syncing|API-based syncing]]. While read-only clients may continue to work properly, clients that write to the API are likely to need updating.+As [[https://​groups.google.com/​d/​msg/​zotero-dev/​egIdfVmWEeo/​dkOfupK7EXoJ|announced on zotero-dev]],​ version 2 of the [[start|Zotero ​Web API]] brings many changes to enable [[syncing|API-based syncing]]. While read-only clients may continue to work properly, clients that write to the API are likely to need updating.
  
 This page provides a brief summary of changes and may not be comprehensive. See the appropriate documentation sections for full details on all changes. This page provides a brief summary of changes and may not be comprehensive. See the appropriate documentation sections for full details on all changes.
Line 13: Line 13:
   * Object ETags have been replaced by [[syncing#​version_numbers|library/​object versions]]. ''​If-Match''​ has been replaced by ''​If-Unmodified-Since-Version''​ and JSON version properties.   * Object ETags have been replaced by [[syncing#​version_numbers|library/​object versions]]. ''​If-Match''​ has been replaced by ''​If-Unmodified-Since-Version''​ and JSON version properties.
   * Object writes no longer return Atom feeds with the newly created objects. Single-object writes return ''​204 No Content'',​ while [[write_requests#​creating_multiple_objects|multi-object writes]] return ''​200 OK''​ with a JSON document indicating the status of each write.   * Object writes no longer return Atom feeds with the newly created objects. Single-object writes return ''​204 No Content'',​ while [[write_requests#​creating_multiple_objects|multi-object writes]] return ''​200 OK''​ with a JSON document indicating the status of each write.
-  * ''​X-Zotero-Write-Version''​ has changed to ''​Zotero-Write-Version''​.+  * ''​X-Zotero-Write-Token''​ has changed to ''​Zotero-Write-Token''​.
   * Child items can no longer be created by including ''​note''​ or ''​attachment''​ properties when creating top-level items or by POSTing to ''<​userOrGroupPrefix>/​items/<​itemKey>/​children''​. Instead, child items can be created or moved by including a ''​parentItem''​ property in the item's JSON.   * Child items can no longer be created by including ''​note''​ or ''​attachment''​ properties when creating top-level items or by POSTing to ''<​userOrGroupPrefix>/​items/<​itemKey>/​children''​. Instead, child items can be created or moved by including a ''​parentItem''​ property in the item's JSON.
   * New collection JSON objects can no longer be POSTed directly. Instead, collections must be within a top-level ''​collections''​ object, similar to the ''​items''​ object used for items. ​   * New collection JSON objects can no longer be POSTed directly. Instead, collections must be within a top-level ''​collections''​ object, similar to the ''​items''​ object used for items. ​
   * The ''​parent''​ property for collections has been changed to ''​parentCollection''​.   * The ''​parent''​ property for collections has been changed to ''​parentCollection''​.
   * The collections an item belongs to can be read and modified via the item's ''​collections''​ property. The previous POST and DELETE requests have been removed.   * The collections an item belongs to can be read and modified via the item's ''​collections''​ property. The previous POST and DELETE requests have been removed.
dev/web_api/v2/changes_from_v1.txt ยท Last modified: 2017/11/27 04:20 by bwiernik