Get shares filtered by share type via API

[jvillafanez]

New option in the "get shares" API to filter the shares by share type (available from 10.6.0)
Related to owncloud/core#38000

What Needs to be Documented?

Where Does This Need To Be Documented?

Why Should This Change Be Made? (Optional)

What Type Of Content Change Is This? (Optional)

• New Content Addition
• Old Content Deprecation
• Existing Content Simplification
• Bug Fix to Existing Content

Which Manual Does This Relate To? (Optional)

• Admin Manual
• Developer Manual
• User Manual
• Android
• iOS
• Branded Clients
• Desktop Client
• Other

[phil-davis]

Note:
https://doc.owncloud.com/server/developer_manual/core/apis/ocs-share-api.html#get-all-shares
currently has some rubbish - talks about /ocs/v1.php/apps/files_sharing/api/v1/shares/pending but should be for "ordinary" (not pending) shares.
Similar problem in https://doc.owncloud.com/server/developer_manual/core/apis/ocs-share-api.html#get-information-about-a-known-share
/ocs/v1.php/apps/files_sharing/api/v1/shares/pending/<share_id>

There should be separate examples for "all shares" and "pending shares".

So that will really need to be fixed first, and then add the doc for the filtering by share type.