Indicates the total new connections per second. For the purposes of this endpoint, a connection is initiated when a user agent (e.g., web browser) requests content through the CDN. After which, the user agent determines whether future requests within that session will reuse that connection or whether new connections will be established.
How is this statistic calculated?
This statistic is calculated using the following two steps:
A request to find out the total number of new connections per second is described below.
HTTP Method | Request URI |
---|---|
GET |
https://api.transactcdn.com/v2/realtimestats/customers/AccountNumber/media/Platform/connections |
Define the following variables when submitting the above request.
VariableA variable represents a value that must be replaced. A variable consists of either a URL segment (e.g., "0001" in /0001/) or a query string value (e.g., "3" in mediaTypes=3). | Description |
---|---|
Required |
|
Required |
Replace this variable with an integer that indicates the platform for which a report will be generated.
|
This endpointIdentifies a request's connection point to our REST API service. only takes advantage of common request headers.
Request body parameters are not required by this endpoint.
The response to the above request includes an HTTP status code, response headers, and a response body.
A status code indicates whether the request was successfully performed.
The response for this endpoint only includes standard HTTP response headers.
The response body for a successful request contains the following response parameter:
Name | Data Type | Description |
---|---|---|
Result |
Number floating-point |
Indicates the total number of new connections per second on the specified platform. |
The response body for an unsuccessful request may contain an error parameter that provides additional information.
A sample JSON request is provided below.
GET https://api.transactcdn.com/v2/realtimestats/customers/0001/media/14/connections HTTP/1.1
Authorization: TOK:12345678-1234-1234-1234-1234567890ab
Accept: application/json
Host:api.transactcdn.com
A sample JSON response is provided below.
HTTP/1.1 200 OK
Cache-Control: private
Content-Type: application/json; charset=utf-8
Date: Thu, 15 Apr 2021 12:00:00 GMT
Content-Length: 35
{ "Result" : 21099.000994 }
A sample XML request is provided below.
GET https://api.transactcdn.com/v2/realtimestats/customers/0001/media/14/connections HTTP/1.1
Authorization: TOK:12345678-1234-1234-1234-1234567890ab
Accept: application/xml
Host:api.transactcdn.com
A sample XML response is provided below.
HTTP/1.1 200 OK
Cache-Control: private
Content-Type: application/xml; charset=utf-8
Date: Thu, 15 Apr 2021 12:00:00 GMT
Content-Length: 567
<Connection xmlns="http://www.whitecdn.com/schemas/apiservices/" xmlns:i="http://www.w3.org/2001/XMLSchema-instance"> <Result>21099.000994</Result> </Connection>