list uri fragment discussions

Description

Load a list of discussions for a URI fragment.

Parameters

Comments parameter

The comment display must be one of:

• all – all comments in the discussion
• archive – all comments including archived comments
• first – only the first comment
• last – only the last comment
• none – no comments

Returngroups parameter

Must be one of:

• none – do not include the group
• user – only include the group that the use belongs to
• all (Only administrators can use this option)

Attachedto parameter

Must be one of:

• none
• all

Permission

The member on the request needs to be a guest or higher unless the URI is in a public group.

Response

The output has the following format:

<uri id="23"
     type="..."
     scheme="..."
     host="..."
     port="..."
     path="..."
     decodedpath="..."
     mediatype="...">
  <displaytitle>...</displaytitle>
  <labels>...</labels>
  <locator fragment="12">
    <discussion id="123"
                title="My thread"
                replycount="3"
                lastcommentid="234"
                lastcommentdate="2012-08-20T14:27:48+10:00">
      <comment id="234"
               contentrole="File Attachment"
               created="2012-03-08T12:34:00+10:00">
        <title>My thread</title>
        <content type="text/plain">Some text</content>
        <attachment>
          <uri id="189"> ... </uri>
        </attachment>
        <attachment fragment="5">
          <uri id="289"> ... </uri>
        </attachment>
      </comment>
    </discussion>
    <discussion id="100"> ... </discussion>
    <attachedto>
      <comment ...> ... </comment>
    </attachedto>
    ...
  </locator>
  ...
</uri>

Error Handling