Web service API

How to use PageSeeder's Web service API

get discussion

/members/{member}/discussions/{discussion} [GET]

com.pageseeder.comment.GetDiscussion

Description

Loads a discussion. If a reply comment ID is specified for the discussion it will return the containing discussion.

Parameters

NameDescriptionRequiredTypeDefault value
comments To indicate which comment(s) in the discussion should be displayed. no enum all
discussionsize the maximum number of comments to return per discussion no string 1000
returngroups the groups to return in the output, can be "none","user","all"(administrator only will include all comments) no string none

Enum for 'comments'

The comment display should 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

If the comments parameters does not match one of the valid values, it is simply ignored.

Permission

Undocumented permissions requirements.

Response

The output has the following format:

<discussion id="123"
            title="My thread"
            replycount="3"
            lastcommentid="234"
            lastcommentdate="2012-08-20T14:27:48+10:00">
   <uri id="789">...</uri>
   <locator fragment="2"/>
   <comment id="234"
            contentrole="File Attachment"
            created="2012-03-08T12:34:00+10:00">
      <title>My thread</title>
      <content id="201"
               type="text/plain">
         Some text
      </content>
      <attachment>
         <uri id="189">...</uri>
      </attachment>
      <attachment fragment="5">
         <uri id="289">...</uri>
      </attachment>
     [<group .../>...]
   </comment>
</discussion>

Error handling

No specific errors expected for this service.

Created on , last edited on