API to query metadata of public share links

[mgallien]

How to use GitHub

• Please use the 👍 reaction to show that you are interested into the same feature.
• Please don't comment if you have no relevant information to add. It's just extra noise for everyone subscribed to this issue.
• Subscribe to receive notifications on status change and new comments.

Is your feature request related to a problem? Please describe.
We want to have a good support for syncing public shared folders in Files clients.
See nextcloud/files-clients#9

Describe the solution you'd like
We need a server API to get the following information:

• public link name
• shared by user xy (so user name having create the public share link)

Describe alternatives you've considered
I have checked the web UI and there is no existing server API that we can use to get this information.

Additional context
Current implementation for desktop client nextcloud/desktop#4175

[mgallien]

@PVince81 @tobiasKaminsky would be nice to have this schedule soon to be able to finish the desktop client implementation

[PVince81]

Tasks:

• expose all those on the root Webdav as attributes as they are not yet
  • public link name, which is actually the folder name itself: {http://owncloud.org/ns}display-name
  • user display name (but id not needed): {http://owncloud.org/ns}owner-display-name'
    • only expose a value if the profile page visibility is set to public, otherwise return an empty string
  • it's likely that the user id is already exposed through Webdav props {http://owncloud.org/ns}owner-id

[PVince81]

as discussed with @mgallien:

• we agreed to already decide the property names in advance so that client dev can continue and be released
• the client will read those properties as use the "placeholder" approach if they are empty or non-existent, this logic will be needed anyway for the case where the user decided to have their info private on the profile page

cc @jancborchardt also see above for the profile page bits

[PVince81]

I've tested the share label, and apparently the label that one can set for a link share is not exposed at all, it's only an internal reference. The name shown by the web UI is the name of the shared folder itself.

There's also a "note to recipient" that becomes available as a bubble in the web UI, I assume that this is not something we want to expose for clients ? @jancborchardt @mgallien

[PVince81]

(if interested in the note, we could expose it through {http://nextcloud.com/ns}note)

[jancborchardt]

Let's first keep it as simple as possible MVP-style? Both label and note can be omitted until we the feature sees usage and it's requested.