From 9362e6a4a9d6a0c827c0ca1363bece89901277da Mon Sep 17 00:00:00 2001 From: Jos Poortvliet Date: Wed, 29 Jul 2020 19:33:12 +0200 Subject: [PATCH 1/2] Update externalapi.rst Link to open collaboration services instead. Don't merge yet, this page has to be updated first... will take a bit I suppose. --- developer_manual/core/externalapi.rst | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/developer_manual/core/externalapi.rst b/developer_manual/core/externalapi.rst index f0621f355..e232c3555 100644 --- a/developer_manual/core/externalapi.rst +++ b/developer_manual/core/externalapi.rst @@ -7,8 +7,8 @@ External API Introduction ------------ The external API inside Nextcloud allows third party developers to access data -provided by Nextcloud apps. Nextcloud follows the `OpenCloudMesh -specification `_ (draft). +provided by Nextcloud apps. Nextcloud follows the `Open Collaboration Services +specification `_. Usage ----- From c92e79a9cbe350be8f9fc6f153c692a83e2d1d2e Mon Sep 17 00:00:00 2001 From: Jos Poortvliet Date: Wed, 29 Jul 2020 20:21:56 +0200 Subject: [PATCH 2/2] Update externalapi.rst --- developer_manual/core/externalapi.rst | 10 ++++++++++ 1 file changed, 10 insertions(+) diff --git a/developer_manual/core/externalapi.rst b/developer_manual/core/externalapi.rst index e232c3555..aae504935 100644 --- a/developer_manual/core/externalapi.rst +++ b/developer_manual/core/externalapi.rst @@ -117,3 +117,13 @@ The statuscode can be any of the following numbers: * **997** - not authorized * **998** - not found * **999** - unknown error + +Changing API and backwards compatibility +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ + +We aim to keep our API as stable as possible to avoid breaking third-party apps. +Before an API is allowed to be removed, it should be marked as deprecated for at +least 2 years (6 Nextcloud releases) before it gets removed. + +Changing the API `should be discussed in a github issue in our server repo +`_. A pull request is most welcome.