Get the total number of concurrent connections per minute for your Live Stream Acceleration domains. Service-type should be one of the Live Stream Acceleration service types: live-push, live-pull, or live-hls. You can specify multiple service types by separating them with semicolons. Request parameters allow you to specify a time period and timezone for the output.
Header |
Description |
Required |
Authorization |
Authorization string for the request |
Yes |
Host |
URI for the QUANTIL SDK (i.e., api.quantil.com) |
Yes |
Date |
The date and time of the request. |
Yes |
Accept |
Indicates the accepted format (i.e., application/xml) |
Yes |
Parameter |
Description |
Required |
datefrom |
RFC3339 formatted date indicating the starting date. Example: 2013-01-01T22:30:00+08:00 |
Yes |
dateto |
RFC3339 formatted date indicating the ending date. Example: 2013-01-01T22:30:00+08:00 |
Yes |
timezone |
Indicates the timezone for the report data. It must be relative to GMT and specified in the format GMT+n where -12<= n <= 12. For example, timezone=GMT-7 and timezone=GMT+8. If the parameter is unspecified, results will be in the GMT timezone. |
No |
This request does not include an XML document in the request body.
GET /api/report/{service-type}/concurrency/ HTTP/1.1
Authorization: <authorization string>
Host: api.quantil.com
Date: <date>
Accept: application/xml
Here is the structure of a request using the curl utility.
curl -i --url https://api.quantil.com/api/report/{service-type}/concurrency ?datefrom = {date from} & dateto = {date to}& timezone = {timezone}
-X GET
-u {user}: {password}
-H 'Date: Fri, 26 Oct 2012 06:33:26 GMT'
-H 'Accept: application/xml'
curl -i --url 'https://api.quantil.com/api/report/live-pull/concurrency?datefrom=2014-09-11T00:00:00%2D08:00&dateto=2014-09-20T23:59:59%2D08:00&timezone=GMT%2B08' -u apiuser:XP9Df3yl42255HQty4IFy3JfVUVs= -H 'Date: Wed, 08 Oct 2014 18:07:46 PDT' -H 'Accept: application/xml'
HTTP/1.1 200 OK
Date: <date>
Content-Type: application/xml; charset = utf-8
x-cnc-request-id: {id string auto generated by the QUANTIL server}
Element |
Description |
concurrency-report |
container for concurrency information. It will contain zero or more <concurrency-data> child elements indicating concurrent connections at different times. |
concurrency-data |
this container object contains a <timestamp> element and a <concurrency> element describing the concurrent connections at a particular time. |
timestamp |
indicates the date and time |
concurrency |
number of concurrent connections |
The following shows daily page view data.
HTTP/1.1 200 OK
Date: Thu, 09 Oct 2014 01:07:44 GMT
Accept-Ranges: bytes
Server: WS-web-server
x-cnc-request-id: 3922739
ContentType: application/xml;charset=UTF-8
Content-Type: application/xml;charset=UTF-8
Content-Length: 523
<concurrency-report>
<concurrency-data>
<timestamp>2014-07-31 23:00:00</timestamp>
<concurrency>100</concurrency >
</concurrency-data>
<concurrency-data>
<timestamp>2014-07-31 23:01:00</timestamp>
<concurrency>110</concurrency >
</concurrency-data>
<concurrency-data>
<timestamp>2014-07-31 23:02:00</timestamp>
<concurrency>120</concurrency >
</concurrency-data>
<concurrency-data>
<timestamp>2014-07-31 23:03:00</timestamp>
<concurrency>130</concurrency >
</concurrency-data>
</concurrency-report
Error |
Description |
HTTP status code |
DateSpanError |
The time span exceeds the limit. |
400 |
InvalidDatePeriod |
The date specified is invalid. |
400 |
InvalidServiceType |
The service type specified is invalid. |
400 |