Skip to main content

 Web service API

How to use PageSeeder's Web service API

list filter comments public

/comments/filter [GET]

com.pageseeder.comment.GetCommentsByFilter

Description

Load public comments by filter.

This service is now deprecated, use service /comments/find [GET] instead.

Parameters

NameDescriptionRequiredTypeDefault value
groupsA comma-separated list of group names the comments must belong toyesstrings
archivedif true include archived commentsnobooleanfalse
attachmentsThe attachments to include
(can be none, context or all)
noenumall
authorThe member id of the comments authornolong
contentsThe contents to include
(can be none or all)
noenumall
createdafterThe date time after which the comments were created e.g. 2010-10-25T12:26:00+10:00nodatetime
createdbeforeThe date time before which the comments were created e.g. 2011-08-25T10:20:00-04:00nodatetime
labelscomma-separated list of labelsnostring
moderatedif true include moderated (not accepted) commentsnobooleanfalse
pageThe page to loadnolong1
pagesizeThe number of results per pageno long1000
pathsThe context URI paths for the comments - must be URL encoded (comma-separated list with optional * suffix)nopaths
positionif first only search first comment in a discussion (might be faster when using paths)nostringany
returngroupsThe groups to return in the output (can be none, or specified)noenumnone or if multiple groups specified
statusescomma-separated list of statusesnostring
titleThe title the comments must have (optional wildcard * suffix, use ** to escape)nostring
typeThe type the comments must have (optional wildcard * suffix, use ** to escape)nostring

Permission

If the parameter emails is set to all, the permission is restricted to administrator only. Otherwise, the permission is public.

The other restriction is that the groups parameter can only list groups that have public access.

Response

The output has the following format:

<comments>
  <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>
    <context>
      <group id="3" name="acme-test" />
    </context>
  </comment>

  <comment   id="567">
    ...
    <context fragment="2">
      <uri id="789">...</uri>
    </context>
  </comment>
</comments>

Error Handling

CodeCause / Description
0x1306 The Group is invalid or not accessible
0x1312 The createdafter or createdbefore date is invalid
0x1313 The author is invalid

 

Created on , last edited on