search

nextcloud / documentation

📘 Nextcloud documentation
https://docs.nextcloud.com
Other
510 stars 1.81k forks source link

REST or OCS #12157

Open dartcafe opened 2 months ago

dartcafe commented 2 months ago

This is more a question than a suggestion.

Under https://docs.nextcloud.com/server/latest/developer_manual/client_apis/OCS/index.html the usage of OCS Interface seems to be recommended (see section 'PREFER to expose your APIs using OCS'), but when clicking through to https://docs.nextcloud.com/server/latest/developer_manual/basics/controllers.html#ocs it says REST APIs are recommended.

Either it is confusing or there is something I don't understand.

provokateurin commented 1 month ago

OCS is what should be used. @christianlupus and me already noticed this some time ago, but forgot to fix it back then. OCS is not legacy and is the way every API in Nextcloud (except for other standard like e.g. WebDAV) should be implemented.

christianlupus commented 1 month ago

I was planning to update the docs here. So, please ping me if you want to work on it or have any suggestions...

christianlupus commented 1 month ago

I am working on #12264 to address this issue here.