Web service API

How to use PageSeeder's Web service API

member

/members/{member} [PATCH]

com.pageseeder.member.EditMember

Description

Edit the account details of a member.

Member details

Both the firstname and surname are limited to 20 characters.

The member-username must be less than 100 characters, unique and cannot contain a '@'. The username is required unless the an email address is specified.

The email must be less than 100 characters, unique and be a valid Email address. The email address is required unless a username is specified.

Note

If the email is changed and force-email-change is not true then the email will not be changed but a confirmation message will be sent to the new email address.

The member details are only modified if they are specified in the request.

Password details

The member-password must be less than 100 characters. When the Password is not specified, the member's email will be used if no confirmation is needed, otherwise a new password will be generated.

Passwords must satisfy a given strength check to be accepted:

  • Regular members must have at least a MEDIUM strength.
  • Administrators must use a STRONG password.

Users MUST include their current password using current-password in order to be able to change their password.

Note

By default, an email is sent to the user when their password is changed unless member status is set-password (i.e. the member is setting up their account). To override this behavior, set password-email to "false".

Email templates

This service will use the default PageSeeder templates.

To use customized emails use the customFolder template property.

Parameters

NameDescriptionRequiredTypeDefault value
current-password The member's current password (required by non-administrator if a new password is specified) maybe string
email The member's email no email
email-attachments "true" to include attachments to email notifications, "false" to include links to PageSeeder instead no boolean
firstname The member's first name no string
force-email-change Set to "true" to change the email address without notification (administrator only) no boolean false
member-password The member's new password  no string
member-username The member's username no  string
on-vacation Set to "true" to suspend normal email notifications no boolean
password-email Set to "false" to change the password without notification (adminstrator only) no boolean true
surname The member's last name no string
token The account activation token yes, if not authenticated string

Permission

This service can only be invoked by the user herself or an Administrator .

Only administrators can change a password without having to submit the current password.

Member details

Response

The XML returned is always:

<member-modified>
  <member id="[member id]"
          firstname="[first name]"
          surname="[surname]"
          username="[username]"
          status="[activated|unactivated]">
    <fullname>[full name]</fullname>
  </member>
</member-modified>

Error handling

CodeCause / Description
0x1001 If the username contains the character '@'.".
0x1002 If the email address is invalid.
0x1004 If the username or email are already in use.
0x1007 If the first name or surname is longer than 20 characters
0x1009 If the username is too long
0x100A If the email address is longer then 100 characters
0x100B If the new password is too long
0x100C If the current password is not specified
0x1015 If the new password is too weak
0x1017 If the current password is incorrect
0x6002 If the email change notification could not be sent
0x6003 If the password change notification could not be sent

Created on , last edited on