You can get the list of groups by sending the GET request to the following URL: /group.
Permission to run the request: Account Owner, Administrator, Organization Administrator, Publisher.
Parameter | Description |
---|
X-Auth-Account-Url (required) | Base URL of the account, e.g. http://myaccount.ispringlearn.com |
X-Auth-Email (required) | Administrator/Publisher e-mail address. |
X-Auth-Password (required) | Administrator/Publisher password. |
X-Organization-Id (optional) | List of groups in the specified organization. |
Organization Administrators can get the list of groups only within their own organization.
If the specified organization is not found, you will get the list of all groups in the response. As for Publishers and Organization Administrators, they will get the list of groups within their own organization in this case.
After the request has been completed, the system returns the response with Code 200. The body of the response contains an xml file with information about the groups.
Possible Response Codes
Code | Text | Description |
---|
200 | Ok | The request has been processed successfully. |
Sample Request
GET /group HTTP/1.1
Host: api.ispringonline.com
X-Auth-Account-Url: http://myaccount.ispringlearn.com
X-Auth-Email: email@email.com
X-Auth-Password: password
XML
Sample Response
HTTP/1.1 200 OK
Connection: close
<?xml version="1.0" encoding="UTF-8"?>
<groups>
<group>
<groupId>1</groupId>
<name>test</name>
<description></description>
<organizationId>1</organizationId>
<users>
<id>1</id>
<id>2</id>
</users>
</group>
<group>
...
</group>
</groups>
XML