JSON API » timegroups » timegroups/periods/list

Gets the fields of all time periods in a given time group.

Input parameters

Requires authentication and the administrator role privilege.

NameTypeDescriptionRequiredDefault value
auth_usernameStringAuthentication username.Yes
auth_passwordStringAuthentication password.Yes
timegroupIntegerID of time group to get time periods for.Yes

Responses

CodeDescription
200Success.
401The authentication details provided are invalid.
402Your role does not allow this.
404The time group does not exist, or you do not have permission to view it.

Data returned

An array of fields, corresponding to the rows of the time_periods table in the database.

Example: With required parameters

http://enswitch.example.com/api/json/timegroups/periods/list/?auth_username=user;auth_password=password;timegroup=123

{ "responses":[ { "code":"200", "key":"", "message":"OK" } ], "data":[ { "id":1, "name":"example1", ... }, { "id":2, "name":"example2", ... } ] }

Change history

VersionChanges
3.13Function added.