get uri forurl
/members/{member}/uris/forurl [GET]
| API Support | Available since | Last updated | Output |
|---|---|---|---|
| 5.9900 | 5.9900 | xml, json |
Description
Specify a URL in the request to retrieve information about a single URI.
This service does not return content, it returns key information about a URI such as media type, identifiers, type and more.
Use this service when a URL is known, but an identifier or permalink is required.
Parameters
| Name | Description | Required | Type | Default |
|---|---|---|---|---|
| url | The url to look for | yes | url | |
| sharing | Whether to include sharing information | no | boolean | false |
Permission
This service is restricted to a member with access to the URI.
Response
If found, the corresponding URI is returned as a single <uri> element.
<uri id="[id]"
scheme="[scheme]"
host="[host]"
port="[port]"
path="[path]"
decodedpath="[decodedpath]"
external="[true|false]"
[archived="true"]
[folder="true"]
[docid="[docid]"]
[mediatype="[mediatype]"]
[documenttype="[documenttype]"]
[title="My Document"]
[created="[created]"]
[modified="[modified]"]
[sharing="[private|shared]"]>
<displaytitle>My Document</displaytitle>
[<description>This is my document</description>]
[<labels>mylabel1,mylabel2</labels>]
[<sharing hidden="2">
<share editable="true"
addcomments="true"
default="true">
<group name="my-group1" .../>
</share>
<share editable="true"
addcomments="false">
<group name="my-group2" .../>
</share>
<share editable="false"
addcomments="true">
<group name="my-group3" .../>
</share>
</sharing>]
</uri>
Error Handling
No specific errors expected for this service.