mirror of
https://github.com/nextcloud/documentation.git
synced 2026-01-03 18:26:42 +07:00
52 lines
1.1 KiB
ReStructuredText
52 lines
1.1 KiB
ReStructuredText
==============
|
|
OCS Sharee API
|
|
==============
|
|
|
|
The OCS Sharee API allows you to access the sharing API from outside over
|
|
pre-defined OCS calls.
|
|
|
|
The base URL for all calls to the share API is: *<nextcloud_base_url>/ocs/v1.php/apps/files_sharing/api/v1*
|
|
|
|
All calls to OCS endpoints require the ``OCS-APIRequest`` header to be set to ``true``.
|
|
|
|
Search
|
|
------
|
|
|
|
Search sharees
|
|
^^^^^^^^^^^^^^
|
|
|
|
Get all sharees matching a search term.
|
|
|
|
* Syntax: /sharees
|
|
* Method: GET
|
|
|
|
* URL Arguments: search - (string) the search term
|
|
* URL Arguments: lookup - (bool) whether to search globally on the Nextcloud lookup server
|
|
* URL Arguments: perPage - (int) number of sharees per page
|
|
* URL Arguments: itemType - (string) type of share, e.g. "file"
|
|
|
|
* Result: XML with all sharees
|
|
|
|
Status codes:
|
|
|
|
* 100 - successful
|
|
|
|
Recommendation
|
|
--------------
|
|
|
|
Sharee recommendations
|
|
^^^^^^^^^^^^^^^^^^^^^^
|
|
|
|
Get sharees the sharer might want to share with.
|
|
|
|
* Syntax: /sharees_recommended
|
|
* Method: GET
|
|
|
|
* URL Arguments: itemType - (string) type of share, e.g. "file"
|
|
|
|
* Result: XML with recommended sharees
|
|
|
|
Status codes:
|
|
|
|
* 100 - successful
|