# The eXtremeDB/rt RESTrt Resources

> The mcorestrt library provides the following resources via a REST interface. (The response data is encoded using JSON notation.)

> /api | Lists the information about eXtremeDB/rt version and the registered web services. |
>     {
>     	v: version number,
>      	rev: revision number,
>      	type: "rt",
>     	services: [ comma-separated list of available services ],
>     	startTime: host time
>     }
> /api/db | Lists names of the available eXtremeDB/rt databases |
>     {
>     	databases: [ comma-separated list of names ]
>     }
> /api/stats | Provides database statistics (depending on the `agg` request parameter - for each database connection or grouped) |
>     http://host/api/stats?agg=1

>     {
>     	now: timestamp,
>     	counters:[
>     		{
>     			db: database number,
>     			values: [ comma-separated list of counters’ values ]
>     		},
>     		...
>     	],
>     	hist: {
>     		r: value range,
>     		v: [ comma-separated list of values in histogram columns  ]
>     	}
>     	dstats: [
>     		total read,
>     		total read time,
>     		max read time,
>     		total write,
>     		total write time,
>     		max write time,
>     		sync count,
>     		total sync time,
>     		max sync time
>     	]
>     }

>     http://host/api/stats?agg=0

>     {
>     	now: timestamp,
>     	stats: [
>     		{
>     			db: database number,
>     			con: [
>     				{
>     					id: connection number ,
>     					counters:[ comma-separated list of counters’ values ],
>     					hist: {
>     						r: value range,
>     						v: [ comma-separated list of values in histogram columns ]
>     					},
>     					dstats: [
>     						total read,
>     						total read time,
>     						max read time,
>     						total write,
>     						total write time,
>     						max write time,
>     						sync count,
>     						total sync time,
>     						max sync time
>     					]
>     				},
>     				...
>     			]
>     		},
>     	        ...
>     	]
>     }
> /api/gstatinfo | Provides information about additional (device specific) metrics |
>     {
>     	groups: [
>     		{
>     			id: group number,
>     			name: "group name"
>     		},
>     		...
>     	],
>     	sensors: [
>     		{
>     			id: sensor number,
>     			name: "sensor name",
>     			group: number of the parent group
>     		},
>     		...
>     	],
>     	hist: [
>     		{
>     	src: sensor number,
>     	idx: histogram number
>     }
> /api/gstats | Provides counters’ values for additional (device specific) metrics |
>     {
>     	counters: [comma-separated list of values],
>     	t: timestamp
>     }
> /api/ghist | Provides histogram values for additional (device specific) metrics |
>     {
>     	hist: [
>     		{
>     			r: value range,
>     			v: [ comma-separated list of values in histogram columns]
>     		},
>     		...
>     	],
>     	t: timestamp
>     }