AgileApps Support Wiki Pre Release

Difference between revisions of "REST API:community Resource"

From AgileApps Support Wiki
imported>Aeric
imported>Aeric
m (Text replace - 'Community Tenant' to 'Community Site')
Line 3: Line 3:
===Link a User to the Community===
===Link a User to the Community===
Links an existing Username to a ''Community User''
Links an existing Username to a ''Community User''
:''Learn more: [[Community_Tenancy#Enabling_a_Community_Tenant_with_Existing_Users|Enabling a Community Tenant with Existing Users]]''
:''Learn more: [[Community_Tenancy#Enabling_a_Community_Tenant_with_Existing_Users|Enabling a Community Site with Existing Users]]''


;Method:POST
;Method:POST
Line 28: Line 28:
On a new user registration, the link to the Community Site is automatic.  
On a new user registration, the link to the Community Site is automatic.  


For a new Community in an established [[Tenant|Tenancy]], see [[Community_Tenancy#Enabling_a_Community_Tenant_with_Existing_Users|Enabling a Community Tenant with Existing Users]]
For a new Community in an established [[Tenant|Tenancy]], see [[Community_Tenancy#Enabling_a_Community_Tenant_with_Existing_Users|Enabling a Community Site with Existing Users]]


The Username must be associated with a ''Community User'' in order to login to a Community Site.
The Username must be associated with a ''Community User'' in order to login to a Community Site.

Revision as of 23:54, 3 April 2014

Performs actions on Community Tenancy records via the REST API

Link a User to the Community

Links an existing Username to a Community User

Learn more: Enabling a Community Site with Existing Users
Method
POST
URI
https://{yourDomain}/networking/community/user/operation/linkToCommunity
Request
<syntaxhighlight lang="xml" enclose="div">

<platform>

   <auth>
       <userName>{usermame}</userName>
       <password>{password}</password>
   </auth>

</platform> </syntaxhighlight>

Response
  • On Success, a standard success message is displayed
  • On Error, returns HTTP.FORBIDDEN. (can occur if the user is valid, but does not belong to the community tenant.)

Login a User to the Site

Logs a User into a community site.

On a new user registration, the link to the Community Site is automatic.

For a new Community in an established Tenancy, see Enabling a Community Site with Existing Users

The Username must be associated with a Community User in order to login to a Community Site.

Method
GET
URI
https://{yourDomain}/networking/community/login/site?{query_parameters}
Query Parameters
  • {userName} - username of the site user
  • {password} - password of the site user
For more information, see: Specifying Query Parameters in REST APIs
Response
User details such as first name, last name, and employee number--the same as the Login resource.

Change the User Password

Changes the password of the logged in user. Password policies that are configured for the community tenant will be applicable for change password operation.

Method
POST
URI
https://{yourDomain}/networking/community/user/operation/changePassword
Request
<syntaxhighlight lang="xml" enclose="div">

<platform>

   <user>
       <old_password>{old password}</old_password>
       <password>{new password}</password>
   </user>

</platform> </syntaxhighlight>

Response
  • On Success, a standard success message is displayed
  • On Error, returns HTTP.INTERNAL_SERVER_ERROR

Additional Resources

These REST API resources are also available: