Get Bandwidth

This API is used to get bandwidth with 5 minutes or one day data sample.

1. Request Definition

  • API URL
https://cdn-api.swiftfederation.com/v1.1/report/bandwidth
  • Request Method
POST
  • Request Header

Refer to HTTP Request Headers

  • Request Body

Request Body Data Format: JSON

Field Required Type Description
domains Mandatory string[] Array of domain names.
startTime Mandatory string Start time. Format yyyy-MM-ddTHH:mm:ssZ UTC time.
endTime Mandatory string End time. Format yyyy-MM-ddTHH:mm:ssZ UTC time. If interval is "minute", interval between start time and end time cannot be longer than 24 hours. If interval is "day", interval between start time and end time cannot be longer than 90 days.
fillFixedTime Optional boolean Boolean value if need to fill in zero value for empty data. Values: true or false. Default value: false.
interval Optional string Interval of data spot, could be "minute", "day". For "minute", data spot is for 5 minutes, and for "day", data spot is one day. Default is "minute".
  • Request Body Example
{
    "domains": [
        "www.example1.com",
        "www.example2.com"
    ],
    "startTime": "2018-03-29T17:35:00Z",
    "endTime": "2018-03-29T17:45:00Z",
    "fillFixedTime": "false",
    "interval": "minute"
}


2. Response Definition

  • Response Header

Refer to HTTP Response Headers

  • Response Body
Field Type Description
domain string Name of domain.
bandwidths Bandwidth List of bandwidth data with 5 minutes interval.
Bandwidth Definition
timestamp string Format yyyy-MM-ddTHH:mm:ssZ UTC time. E.g. 2018-03-29T17:35:00Z will return data from 2018-03-29T17:35:00Z to 2018-03-29T17:39:59Z.
value float Bandwidth value, format will be like 94.33. Unit is bps.
  • Response Body Example
[  
    {   
        "domain": "www.example1.com",  
        "bandwidths": [  
            {  
                "timestamp": "2018-03-29T17:35:00Z",  
                "value": 1.01  
            },  
            {  
                "timestamp": "2018-03-29T17:40:00Z",  
                "value": 3.01  
            }  
        ]  
    },  
    {  
        "domain": "www.example2.com",  
        "bandwidths": [  
            {  
                "timestamp": "2018-03-29T17:35:00Z",  
                "value": 4.04  
            },  
            {  
                "timestamp": "2018-03-29T17:40:00Z",  
                "value": 7.04  
            }  
        ]  
    }  
]
© 2019 Conversant Solutions Pte Ltd. All rights reserved.            Updated 2019-05-23 03:46:25

results matching ""

    No results matching ""