Skip to main content

 Services

Web services from /about to /webhooks

get uri forurl

/members/{member}/uris/forurl [GET]

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

NameDescriptionRequiredTypeDefault
urlThe url to look foryesurl
sharingWhether to include sharing informationnobooleanfalse

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]"]>
  <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.

Created on , last edited on