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
dev:web_api:v2:changes_from_v1 [2013/02/12 19:47]
dstillman
dev:web_api:v2:changes_from_v1 [2017/11/27 04:20] (current)
bwiernik Remove Zotero 5 warning
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.1360716435.txt.gz ยท Last modified: 2013/02/12 19:47 by dstillman