Reporting API Resources

This section provides details on the Reporting API’s operation and parameters. See Reporting API Workflow for details on how to call the API.

API Summary

Download the RAML descriptors for this API.

Operation Method Endpoint
Generate a Report POST /reporting-api/v1/reports/{reportName}/versions/{reportVersion}/report-data{?start,end,interval}

Generate a Report

Produce a report in either JSON or CSV format for a specific version of a type of report. Query parameters specify the range of data and the aggregation interval for each record. Specify a Query request object for a corresponding Report response.

POST /reporting-api/v1/reports/{reportName}/versions/{reportVersion}/report-data{?start,end,interval}

Sample: /reporting-api/v1/reports/opresponses-by-time/versions/1/report-data?start=2016-07-01T00%3A00%3A00Z&end=2016-07-02T00%3A00%3A00Z&interval=DAY

Content-Type: application/json

Request Body:

{
    "objectType": "cpcode",
    "objectIds": [
        "536194",
        "536198",
        "539651",
        "539798",
        "539987"
    ],
    "metrics": [
        "top_hits",
        "top_urls",
        "browser_hits",
        "edgres_hits_success",
        "edgres_hits_success_total",
        "edgres_hits_success_min",
        "edgres_hits_success_max",
        "origin_hits_success",
        "origin_hits_success_total",
        "origin_hits_success_min",
        "origin_hits_success_max"
    ],
    "filters": {
        "ip_version": [
            "ipv4"
        ],
        "traffic_type": [
            "standard_secure"
        ]
    }
}
Parameter Type Sample Description
URL Parameters
reportName String opresponses-by-time Identifies the type of report you want to generate. See Available Reports.
reportVersion Integer 1 The version of the report type. Successive versions may support different sets of metrics and filters.
Required Query Parameters
end String 2016-07-02T00:00:00Z Specifies the end of the reported period as an ISO–8601 date with timezone. Any data that matches the end value’s timestamp is excluded from the report.
interval Enumeration DAY The duration of each data record, either FIVE-MINUTE, HOUR, DAY, WEEK, or MONTH. Support for specific interval values may vary by report type.
start String 2016-07-01T00:00:00Z Specifies the start of the reported period as an ISO–8601 date with timezone.

Status 200 application/json

Response Body:

{
    "metadata": {
        "name": "opresponses-by-time",
        "version": "1",
        "start": "2016-08-17T00:00:00Z",
        "end": "2016-08-18T00:00:00Z",
        "groupBy": [
            "timestamp"
        ],
        "interval": "HOUR",
        "objectType": "cpcode",
        "objectIds": [
            "536194",
            "536198",
            "539651",
            "539798",
            "539987"
        ],
        "availableDataEnds": null,
        "suggestedRetryTime": null,
        "rowCount": 24,
        "filters": [
            {
                "name": "ip_version",
                "value": [
                    "ipv4"
                ]
            }
        ],
        "columns": [
            {
                "name": "allEdgeHitsPerSecond",
                "label": "Column description of allEdgeHitsPerSecond for ui"
            },
            {
                "name": "allOriginHitsPerSecond",
                "label": "Column description of allOriginHitsPerSecond for ui"
            },
            {
                "name": "allMidgressHitsPerSecond",
                "label": "Column description of allMidgressHitsPerSecond for ui"
            },
            {
                "name": "allHitsOffload",
                "label": "Column description of allHitsOffload for ui"
            },
            {
                "name": "allHitsOffloadAvg",
                "label": "Column description of allHitsOffloadAvg for ui"
            },
            {
                "name": "allHitsOffloadMin",
                "label": "Column description of allHitsOffloadMin for ui"
            },
            {
                "name": "allHitsOffloadMax",
                "label": "Column description of allHitsOffloadMax for ui"
            },
            {
                "name": "allEdgeHitsTotal",
                "label": "Column description of allEdgeHitsTotal for ui"
            },
            {
                "name": "allEdgeHitsMin",
                "label": "Column description of allEdgeHitsMin for ui"
            },
            {
                "name": "allEdgeHitsMax",
                "label": "Column description of allEdgeHitsMax for ui"
            },
            {
                "name": "allMidgressHitsTotal",
                "label": "Column description of allMidgressHitsTotal for ui"
            },
            {
                "name": "allMidgressHitsMin",
                "label": "Column description of allMidgressHitsMin for ui"
            },
            {
                "name": "allMidgressHitsMax",
                "label": "Column description of allMidgressHitsMax for ui"
            },
            {
                "name": "allOriginHitsTotal",
                "label": "Column description of allOriginHitsTotal for ui"
            },
            {
                "name": "allOriginHitsMin",
                "label": "Column description of allOriginHitsMin for ui"
            },
            {
                "name": "allOriginHitsMax",
                "label": "Column description of allOriginHitsMax for ui"
            },
            {
                "name": "allEdgeResponsetimeAvg",
                "label": "Column description of allEdgeResponsetimeAvg for ui"
            },
            {
                "name": "allEdgeResponsetimeMin",
                "label": "Column description of allEdgeResponsetimeMin for ui"
            },
            {
                "name": "allEdgeResponsetimeMax",
                "label": "Column description of allEdgeResponsetimeMax for ui"
            },
            {
                "name": "allOriginResponsetimeAvg",
                "label": "Column description of allOriginResponsetimeAvg for ui"
            },
            {
                "name": "allOriginResponsetimeMin",
                "label": "Column description of allOriginResponsetimeMin for ui"
            },
            {
                "name": "allOriginResponsetimeMax",
                "label": "Column description of allOriginResponsetimeMax for ui"
            },
            {
                "name": "allEdgeHitsPercent",
                "label": "Column description of allEdgeHitsPercent for ui"
            },
            {
                "name": "2xxEdgeHitsTotal",
                "label": "Column description of 2xxEdgeHitsTotal for ui"
            },
            {
                "name": "2xxEdgeHitsPercent",
                "label": "Column description of 2xxEdgeHitsPercent for ui"
            },
            {
                "name": "3xxEdgeHitsTotal",
                "label": "Column description of 3xxEdgeHitsTotal for ui"
            },
            {
                "name": "3xxEdgeHitsPercent",
                "label": "Column description of 3xxEdgeHitsPercent for ui"
            },
            {
                "name": "4xxEdgeHitsTotal",
                "label": "Column description of 4xxEdgeHitsTotal for ui"
            },
            {
                "name": "4xxEdgeHitsPercent",
                "label": "Column description of 4xxEdgeHitsPercent for ui"
            },
            {
                "name": "5xxEdgeHitsTotal",
                "label": "Column description of 5xxEdgeHitsTotal for ui"
            },
            {
                "name": "5xxEdgeHitsPercent",
                "label": "Column description of 5xxEdgeHitsPercent for ui"
            },
            {
                "name": "otherEdgeHitsTotal",
                "label": "Column description of otherEdgeHitsTotal for ui"
            },
            {
                "name": "otherEdgeHitsPercent",
                "label": "Column description of otherEdgeHitsPercent for ui"
            },
            {
                "name": "allOriginHitsPercent",
                "label": "Column description of allOriginHitsPercent for ui"
            },
            {
                "name": "2xxOriginHitsTotal",
                "label": "Column description of 2xxOriginHitsTotal for ui"
            },
            {
                "name": "2xxOriginHitsPercent",
                "label": "Column description of 2xxOriginHitsPercent for ui"
            },
            {
                "name": "3xxOriginHitsTotal",
                "label": "Column description of 3xxOriginHitsTotal for ui"
            },
            {
                "name": "3xxOriginHitsPercent",
                "label": "Column description of 3xxOriginHitsPercent for ui"
            },
            {
                "name": "4xxOriginHitsTotal",
                "label": "Column description of 4xxOriginHitsTotal for ui"
            },
            {
                "name": "4xxOriginHitsPercent",
                "label": "Column description of 4xxOriginHitsPercent for ui"
            },
            {
                "name": "5xxOriginHitsTotal",
                "label": "Column description of 5xxOriginHitsTotal for ui"
            },
            {
                "name": "5xxOriginHitsPercent",
                "label": "Column description of 5xxOriginHitsPercent for ui"
            },
            {
                "name": "otherOriginHitsTotal",
                "label": "Column description of otherOriginHitsTotal for ui"
            },
            {
                "name": "otherOriginHitsPercent",
                "label": "Column description of otherOriginHitsPercent for ui"
            }
        ],
        "uri": "/reporting-report-executor/reports/traffic-by-time/v1"
    },
    "data": [
        {
            "timestamp": "2016-08-17T00:00:00Z",
            "allEdgeHitsPerSecond": 15164,
            "allOriginHitsPerSecond": 850,
            "allMidgressHitsPerSecond": 923,
            "allHitsOffload": 60
        },
        {
            "timestamp": "2016-08-17T01:00:00Z",
            "allEdgeHitsPerSecond": 11729,
            "allOriginHitsPerSecond": 24354,
            "allMidgressHitsPerSecond": 39413,
            "allHitsOffload": 63
        },
        {
            "timestamp": "2016-08-17T02:00:00Z",
            "allEdgeHitsPerSecond": 17529,
            "allOriginHitsPerSecond": 1330,
            "allMidgressHitsPerSecond": 18396,
            "allHitsOffload": 66
        },
        {
            "timestamp": "2016-08-17T03:00:00Z",
            "allEdgeHitsPerSecond": 55126,
            "allOriginHitsPerSecond": 8854,
            "allMidgressHitsPerSecond": 62521,
            "allHitsOffload": 60
        },
        {
            "timestamp": "2016-08-17T04:00:00Z",
            "allEdgeHitsPerSecond": 10660,
            "allOriginHitsPerSecond": 16205,
            "allMidgressHitsPerSecond": 47987,
            "allHitsOffload": 78
        },
        {
            "timestamp": "2016-08-17T05:00:00Z",
            "allEdgeHitsPerSecond": 65350,
            "allOriginHitsPerSecond": 60090,
            "allMidgressHitsPerSecond": 40346,
            "allHitsOffload": 23
        },
        {
            "timestamp": "2016-08-17T06:00:00Z",
            "allEdgeHitsPerSecond": 16012,
            "allOriginHitsPerSecond": 9391,
            "allMidgressHitsPerSecond": 9864,
            "allHitsOffload": 51
        },
        {
            "timestamp": "2016-08-17T07:00:00Z",
            "allEdgeHitsPerSecond": 4080,
            "allOriginHitsPerSecond": 26226,
            "allMidgressHitsPerSecond": 29261,
            "allHitsOffload": 97
        },
        {
            "timestamp": "2016-08-17T08:00:00Z",
            "allEdgeHitsPerSecond": 50053,
            "allOriginHitsPerSecond": 47019,
            "allMidgressHitsPerSecond": 64296,
            "allHitsOffload": 81
        },
        {
            "timestamp": "2016-08-17T09:00:00Z",
            "allEdgeHitsPerSecond": 59183,
            "allOriginHitsPerSecond": 37680,
            "allMidgressHitsPerSecond": 53428,
            "allHitsOffload": 84
        },
        {
            "timestamp": "2016-08-17T10:00:00Z",
            "allEdgeHitsPerSecond": 50898,
            "allOriginHitsPerSecond": 20179,
            "allMidgressHitsPerSecond": 34935,
            "allHitsOffload": 97
        },
        {
            "timestamp": "2016-08-17T11:00:00Z",
            "allEdgeHitsPerSecond": 59410,
            "allOriginHitsPerSecond": 15005,
            "allMidgressHitsPerSecond": 57464,
            "allHitsOffload": 24
        },
        {
            "timestamp": "2016-08-17T12:00:00Z",
            "allEdgeHitsPerSecond": 39521,
            "allOriginHitsPerSecond": 11925,
            "allMidgressHitsPerSecond": 35693,
            "allHitsOffload": 88
        },
        {
            "timestamp": "2016-08-17T13:00:00Z",
            "allEdgeHitsPerSecond": 4708,
            "allOriginHitsPerSecond": 58801,
            "allMidgressHitsPerSecond": 30130,
            "allHitsOffload": 93
        },
        {
            "timestamp": "2016-08-17T14:00:00Z",
            "allEdgeHitsPerSecond": 43295,
            "allOriginHitsPerSecond": 26605,
            "allMidgressHitsPerSecond": 26794,
            "allHitsOffload": 77
        },
        {
            "timestamp": "2016-08-17T15:00:00Z",
            "allEdgeHitsPerSecond": 11385,
            "allOriginHitsPerSecond": 12335,
            "allMidgressHitsPerSecond": 53690,
            "allHitsOffload": 94
        },
        {
            "timestamp": "2016-08-17T16:00:00Z",
            "allEdgeHitsPerSecond": 60225,
            "allOriginHitsPerSecond": 27542,
            "allMidgressHitsPerSecond": 35106,
            "allHitsOffload": 34
        },
        {
            "timestamp": "2016-08-17T17:00:00Z",
            "allEdgeHitsPerSecond": 33740,
            "allOriginHitsPerSecond": 6826,
            "allMidgressHitsPerSecond": 21896,
            "allHitsOffload": 25
        },
        {
            "timestamp": "2016-08-17T18:00:00Z",
            "allEdgeHitsPerSecond": 62785,
            "allOriginHitsPerSecond": 26777,
            "allMidgressHitsPerSecond": 2455,
            "allHitsOffload": 79
        },
        {
            "timestamp": "2016-08-17T19:00:00Z",
            "allEdgeHitsPerSecond": 2353,
            "allOriginHitsPerSecond": 54397,
            "allMidgressHitsPerSecond": 5057,
            "allHitsOffload": 98
        },
        {
            "timestamp": "2016-08-17T20:00:00Z",
            "allEdgeHitsPerSecond": 41339,
            "allOriginHitsPerSecond": 56380,
            "allMidgressHitsPerSecond": 11059,
            "allHitsOffload": 84
        },
        {
            "timestamp": "2016-08-17T21:00:00Z",
            "allEdgeHitsPerSecond": 38348,
            "allOriginHitsPerSecond": 31328,
            "allMidgressHitsPerSecond": 4823,
            "allHitsOffload": 79
        },
        {
            "timestamp": "2016-08-17T22:00:00Z",
            "allEdgeHitsPerSecond": 41124,
            "allOriginHitsPerSecond": 45209,
            "allMidgressHitsPerSecond": 47543,
            "allHitsOffload": 12
        },
        {
            "timestamp": "2016-08-17T23:00:00Z",
            "allEdgeHitsPerSecond": 62975,
            "allOriginHitsPerSecond": 29066,
            "allMidgressHitsPerSecond": 63968,
            "allHitsOffload": 67
        }
    ],
    "summaryStatistics": {
        "allHitsOffloadAvg": {
            "value": "3297439138",
            "details": {}
        },
        "allHitsOffloadMin": {
            "value": "3297439138",
            "details": {
                "startdatetime": "2016-08-17T23:00:00Z"
            }
        },
        "allHitsOffloadMax": {
            "value": "3297439138",
            "details": {
                "startdatetime": "2016-08-18T23:00:00Z"
            }
        },
        "allEdgeHitsTotal": {
            "value": "3297439138",
            "details": {}
        },
        "allEdgeHitsMin": {
            "value": "3297439138",
            "details": {
                "startdatetime": "2016-08-17T23:00:00Z"
            }
        },
        "allEdgeHitsMax": {
            "value": "3297439138",
            "details": {
                "startdatetime": "2016-08-18T23:00:00Z"
            }
        },
        "allMidgressHitsTotal": {
            "value": "3297439138",
            "details": {}
        },
        "allMidgressHitsMin": {
            "value": "3297439138",
            "details": {
                "startdatetime": "2016-08-18T23:00:00Z"
            }
        },
        "allMidgressHitsMax": {
            "value": "3297439138",
            "details": {
                "startdatetime": "2016-08-19T23:00:00Z"
            }
        },
        "allOriginHitsTotal": {
            "value": "3297439138",
            "details": {}
        },
        "allOriginHitsMin": {
            "value": "3297439138",
            "details": {
                "startdatetime": "2016-08-18T23:00:00Z"
            }
        },
        "allOriginHitsMax": {
            "value": "3297439138",
            "details": {
                "startdatetime": "2016-08-13T23:00:00Z"
            }
        },
        "allEdgeResponsetimeAvg": {
            "value": "3297439138",
            "details": {}
        },
        "allEdgeResponsetimeMin": {
            "value": "3297439138",
            "details": {
                "startdatetime": "2016-08-18T23:00:00Z"
            }
        },
        "allEdgeResponsetimeMax": {
            "value": "3297439138",
            "details": {
                "startdatetime": "2016-08-13T23:00:00Z"
            }
        },
        "allOriginResponsetimeAvg": {
            "value": "3297439138",
            "details": {}
        },
        "allOriginResponsetimeMin": {
            "value": "3297439138",
            "details": {
                "startdatetime": "2016-08-18T23:00:00Z"
            }
        },
        "allOriginResponsetimeMax": {
            "value": "3297439138",
            "details": {
                "startdatetime": "2016-08-14T23:00:00Z"
            }
        },
        "allEdgeHitsPercent": {
            "value": "3297439138",
            "details": {}
        },
        "2xxEdgeHitsTotal": {
            "value": "3297439138",
            "details": {}
        },
        "2xxEdgeHitsPercent": {
            "value": "3297439138",
            "details": {}
        },
        "3xxEdgeHitsTotal": {
            "value": "3297439138",
            "details": {}
        },
        "3xxEdgeHitsPercent": {
            "value": "3297439138",
            "details": {}
        },
        "4xxEdgeHitsTotal": {
            "value": "3297439138",
            "details": {}
        },
        "4xxEdgeHitsPercent": {
            "value": "3297439138",
            "details": {}
        },
        "5xxEdgeHitsTotal": {
            "value": "3297439138",
            "details": {}
        },
        "5xxEdgeHitsPercent": {
            "value": "3297439138",
            "details": {}
        },
        "otherEdgeHitsTotal": {
            "value": "3297439138",
            "details": {}
        },
        "otherEdgeHitsPercent": {
            "value": "3297439138",
            "details": {}
        },
        "allOriginHitsPercent": {
            "value": "3297439138",
            "details": {}
        },
        "2xxOriginHitsTotal": {
            "value": "3297439138",
            "details": {}
        },
        "2xxOriginHitsPercent": {
            "value": "3297439138",
            "details": {}
        },
        "3xxOriginHitsTotal": {
            "value": "3297439138",
            "details": {}
        },
        "3xxOriginHitsPercent": {
            "value": "3297439138",
            "details": {}
        },
        "4xxOriginHitsTotal": {
            "value": "3297439138",
            "details": {}
        },
        "4xxOriginHitsPercent": {
            "value": "3297439138",
            "details": {}
        },
        "5xxOriginHitsTotal": {
            "value": "3297439138",
            "details": {}
        },
        "5xxOriginHitsPercent": {
            "value": "3297439138",
            "details": {}
        },
        "otherOriginHitsTotal": {
            "value": "3297439138",
            "details": {}
        },
        "otherOriginHitsPercent": {
            "value": "3297439138",
            "details": {}
        }
    }
}

Status 200 text/csv

Response Body:

#METADATA_START
name,some_category
version,1
source,some_category/versions/1
groupBy,service,url
start,2017-01-01T00:00:00Z
end,2017-01-01T00:15:00Z
interval,FIVE_MINUTES,
availableDataEnds,
suggestedRetryTime,
rowCount,2
objectType,cpcode
objectIds,113453,313508
http_method,include_putpost
ip_version,ipv4
#METADATA_END

#SUMMARYSTATISTICS_START
#SUMMARYSTATISTICS_END

#COLUMNS_START
service,url,metric1,metric2
#COLUMNS_END

#DATA_START
ts.download.akamai.com,/../login.php,11,21
ts.download.akamai.com,/:443,12,22
#DATA_END


Last modified: 4/14/2018