Document OCS share api v2

[MorrisJobke]

cc @schiessle @rullzer

[rullzer]

There is no v2 api

[MorrisJobke]

v2.php?

[rullzer]

Aaah you mean the OCS endpoint. Has nothing to do with the sharing API. Sharing API is still on v1. ocs/vX.php/apps/files_sharing/api/v1/shares.

Difference between v1.php and v2.php is mainly that the http return code is now not always 200 :P But what exactly do you want documented?

[MorrisJobke]

Difference between v1.php and v2.php is mainly that the http return code is now not always 200 :P But what exactly do you want documented?

Those changed return codes would be super nice to know ;)

[rullzer]

ok sure. Let me assign to myself. It is on the famous never ending TODO list ;)

[nickvergessen]

https://github.com/nextcloud/documentation/blob/8626051300fbf82b7ed09382a86ee236f0df4b9b/developer_manual/core/ocs-share-api.rst#L28-L28

s/100/200 & s/Statuscodes/HTTP statuscode

[MorrisJobke]

https://github.com/nextcloud/documentation/blob/8626051300fbf82b7ed09382a86ee236f0df4b9b/developer_manual/core/ocs-share-api.rst#L28-L28

s/100/200 & s/Statuscodes/HTTP statuscode

But there is also a change for the case when you create a new share with password and the password is not allowed by the password policy app.

[rullzer]

So you want to document the 403 you get... that is it?

[MorrisJobke]

So you want to document the 403 you get... that is it?

Basically ;) And all the other return codes that got adjusted ;)

[J0WI]

I just run into this issue because the serverinfo app uses v2.php but the documentation does only mention v1.php.

[jamesrom]

An example POST request would be good too. I'm assuming the post body must be XML, but it's not described anywhere in the documentation.