API docs: Document breaking changes in v3

This commit is contained in:
Marcel Klehr 2020-08-12 13:53:18 +02:00
parent 9ae6bc0a21
commit e11ef8cec6
2 changed files with 32 additions and 0 deletions

31
docs/changes.rst Normal file
View File

@ -0,0 +1,31 @@
=======
Changes
=======
.. _changes:
Breaking changes from v2.x to v3.x
==================================
With the upgrade from v2.x of the bookmarks app to v3.x several breaking changes in the API were introduced which were not possible to avoid.
.. object:: Bookmark
:param int id: All bookmark IDs are now integer values instead of strings
.. object:: Folder
:param int id: All folder IDs are now integer values instead of strings
.. get:: /public/rest/v2/bookmark
This endpoint no longer accepts the ``item[tags]`` query parameter. Use the normal ``tags`` param
.. post:: /public/rest/v2/bookmark
This endpoint no longer accepts the ``item[tags]`` query parameter. Use the normal ``tags`` param
.. put:: /public/rest/v2/bookmark
This endpoint no longer accepts the ``item[tags]`` query parameter. Use the normal ``tags`` param

View File

@ -13,3 +13,4 @@ This documentation describes how to use this API.
tag
folder
share
changes