Difference between revisions of "REST API:community Resource"

From AgileApps Support Wiki
imported>Aeric
m (Text replace - 'Community Tenant' to 'Community Site')
imported>Aeric
Line 1: Line 1:
Performs actions on [[Community Tenancy]] records via the [[REST API]]
Performs actions on [[Community Tenant]] records via the [[REST API]]


===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 Site with Existing Users]]''
:''Learn more: [[Community_Tenancy#Enabling_a_Community_Tenant_with_Existing_Users|Enabling a Community Tenant with Existing Users]]''


;Method:POST
;Method:POST
Line 24: Line 24:


===Login a User to the Site===
===Login a User to the Site===
Logs a User into a community site.  
Logs a User into a community tenant.  


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


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]]
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]]


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 00:14, 4 April 2014

Performs actions on Community Tenant records via the REST API

Link a User to the Community

Links an existing Username to a Community User

Learn more: Enabling a Community Tenant with Existing Users
Method
POST
URI
https://{yourDomain}/networking/community/user/operation/linkToCommunity
Request
<platform>
    <auth>
        <userName>{usermame}</userName>
        <password>{password}</password>
    </auth>
</platform>
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 tenant.

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

For a new Community in an established Tenancy, see Enabling a Community Tenant 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
<platform>
    <user>
        <old_password>{old password}</old_password>
        <password>{new password}</password>
    </user>
</platform>
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: