JSON API » machines » machines/statistics/get

Gets statistics for machines.

Input parameters

Requires authentication and the commerce role privilege.

NameTypeDescriptionRequiredDefault value
auth_usernameStringAuthentication username.Yes
auth_passwordStringAuthentication password.Yes
nameStringName of statistic to get. "calls", "channels", "channels_dadhi", "channels_g729", "channels_sip", or "channels_zap".Yes
startIntegerStart Unix timestamp.Recommended0
endIntegerEnd Unix timestamp.RecommendedNow.
machineIntegerID of machine. 0 for all machines in cluster.No0

Failure to specify the start and end may put a heavy load on the database.

Responses

CodeDescription
200Success.
400Invalid input parameters specified. Check the key and message fields for more details.
401The authentication details provided are invalid.
402Your role does not allow this.

Data returned

Fields of statistics.

Example: With required and recommended parameters

http://enswitch.example.com/api/json/machines/statistics/get/?auth_username=user;auth_password=password;name=calls;start=1230000000;end=1240000000

{ "responses":[ { "code":"200", "key":"", "message":"OK" } ], "data":{ "minimum":0, "maximum":10, ... } }

Change history

VersionChanges
3.13Function added.