Rest - Work - Session Groups
Purpose
Used for creating, editing and deleting sessiongroups from the Views system.
Base URL
http://app.views.coop/api/restful/work/sessiongroups
Schema
http://app.views.coop/api/restful/work/sessiongroups/schema(.xml|.json|.xsd)
Searching for Session Groups
curl --url <Base URL>/search?q=<query> -u<username>:<password> -H Content-Type:text/xml
- query - This is a text string to use to search for in the session group records
Extra search parameters are:
- BookingMode - The filters on the booking mode of the session group (None|Session|SessionGroup)
- Archived - By default, only non-archived results are returned. Setting this parameter to 1 result in searching archived records
You can search for any field for a specific value by setting the field as a parameter. Please refer to the schema for fieldnames.
There are also a series of fields that you use -from and -to modifiers to express a range:
- StartDate - yyyy-mm-dd
- EndDate - yyyy-mm-dd
- PlannedSessions - int
- AgeGroupFrom - int
- AgeGroupTo - int
- Created - yyyy-mm-dd
- Updated - yyyy-mm-dd
- Archived - yyyy-mm-dd
Searching for Bookable Session Groups
curl --url <Base URL>/bookable?q=<query> -u<username>:<password> -H Content-Type:text/xml
This is exactly the same the normal Search API, with the exception that BookingMode is set to SessionGroup AND Session and thus passing a value of None to the BookingMode param will result in the parameter being ignored.
There are also a couple of extra fields that you can use the -from and -to modifiers to express a range:
- Cost - int
- BookingFee - int
Fetching a Session Group
curl --url <Base URL>/<id> -u<username>:<password> -H Content-Type:text/xml
Creating Session Groups
Once you have created your data file, you can send it using the following:
curl --url <Base URL> -u<username>:<password> -H Content-Type:text/xml -X POST -d "<xml>"
If there is a problem with creating that record, you will get a response containing all the errors, plus a copy of the translated data you supplied.
If the record was created successfully, the service will return a complete reocrd for the newly created record if the attribute id set as the newly created id.
Updating a sessiongroups
curl --url <Base URL>/<id> -u<username>:<password> -H Content-Type:text/xml -X PUT -d "<xml>"
- id - The ID of the session group
The XML should be in the same format as the create XML.
Archiving a sessiongroups
curl --url <Base URL>/<id> -u<username>:<password> -H Content-Type:text/xml -X PUT -d '<status>1</status>'
- id - The ID of the session group
This will set the archive flag on a session group. If you set the status to 0, then it will remove the archive flag.
Deleting a sessiongroups
curl --url <Base URL>/<id> -u<username>:<password> -H Content-Type:text/xml -X DELETE
- id - The ID of the sessiongroups
This should be used with great care as it will permenently delete a session groups record.