Get Information about a known share¶
To get information about a share when the share ID is known, use the following.
Note: the share ID can be obtained from the output of any of the previous Share API calls or the creation of a new share.
Syntax | <Base URL>/<share id> |
Method | GET |
Arguments | Share id (int) |
Result | XML code with share information |
The following is a list of returned status codes:
HTTP Status Code | Description |
100 | Successful |
404 | Share doesn’t exist |
Poster¶
This example shows the output of share information for share ID “7”
Field | Value |
URL | Base URL for the API of the ownCloud server/<share id> |
User Auth | User ID of the file owner |
Password | User’s Password |
Curl¶
$ curl http://<user>:<passowrd>@<ip>/ocs/v1.php/apps/files_sharing/api/v1/shares/<share_id>
Output¶
<?xml version=”1.0”?> | |
<ocs> | |
<meta> | |
<status>ok</status> | Status=100: successful |
<statuscode>100</statuscode> | |
<message/> | |
</meta> | |
<data> | |
<element> | |
<id>7</id> | Share ID = 7 |
<item_type>file</item_type> | |
<item_source>675</item_source> | |
<parent/> | |
<share_type>0</share_type> | Share type = 0: user |
<share_with>ser72</share_with> | Share with user ser72 |
<file_source>675</file_source> | |
<path>/test share api/ieee.txt</path> | |
<permissions>27</permissions> | |
<stime>1386698116</stime> | |
<expiration/> | |
<token/> | |
<storage>4</storage> | |
<mail_send>0</mail_send> | |
<share_with_displayname>ser72</share_with_displayname> | |
</element> | |
</data> | |
</ocs> |