Ctrlk
medianova.comSupportLog in
For the complete documentation index, see llms.txt. This page is also available as Markdown.

Analytics

Retrieve historical analytics data for your CDN resources, including traffic, request, and performance metrics within a specified time range.

Overview

Analytics Overview Historical Report

post
Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Body
organization_uuidstringRequired
resourcesstring[] · nullableOptional
tierstring · enumOptional

Select the analytics tier to query. Use edge for edge-only analytics. Default is all.

Default: allPossible values:
typestring · enumRequiredPossible values:
fromstring · date-timeRequiredExample: 2024-11-12 00:00:00
tostring · date-timeRequiredExample: 2024-11-12 23:59:59
calc_typestring · enumOptionalDefault: request_numberPossible values:
timezonestring · nullableOptional
Responses
200

Successful Response

application/json
anyOptional
post/api/v1/overview_report/historical
POST /api/v1/overview_report/historical HTTP/1.1
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 178

{
  "organization_uuid": "text",
  "resources": [
    "text"
  ],
  "tier": "all",
  "type": "hit",
  "from": "2024-11-12 00:00:00",
  "to": "2024-11-12 23:59:59",
  "calc_type": "request_number",
  "timezone": "text"
}
No content

Analytics Overview Top Resources

post

Retrieve the top CDN resources within a specified time range, ranked by key traffic and usage signals.

Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Body
organization_uuidstringRequired

Unique identifier of the organization in the Medianova Control Panel.

resourcesstring[] · nullableOptional

List of resource UUIDs to include. Use null to include all resources.

tierstring · enumOptional

Select the analytics tier to query. Use edge for edge-only analytics. Default is all.

Default: allPossible values:
fromstring · date-timeRequired

Start timestamp (inclusive) of the analytics query range.

Example: 2024-11-12 00:00:00
tostring · date-timeRequired

End timestamp (inclusive) of the analytics query range.

Example: 2024-11-12 23:59:59
timezonestring · nullableOptional

Time zone used to interpret the query time range (for example, Europe/Istanbul).

limitinteger · nullableOptional

Maximum number of resources to return.

pageinteger · nullableOptional

Page number for paginated results. Default is 1.

Default: 1
Responses
200

Successful Response

application/json
anyOptional
post/api/v1/overview_report/top_resources
POST /api/v1/overview_report/top_resources HTTP/1.1
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 155

{
  "organization_uuid": "text",
  "resources": [
    "text"
  ],
  "tier": "all",
  "from": "2024-11-12 00:00:00",
  "to": "2024-11-12 23:59:59",
  "timezone": "text",
  "limit": 1,
  "page": 1
}
No content

Analytics Overview Errors

post

Retrieve a summary of error activity for your CDN resources within a specified time range.

Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Body
organization_uuidstringRequired

Unique identifier of the organization in the Medianova Control Panel.

resourcesstring[] · nullableOptional

List of resource UUIDs to include. Use null to include all resources.

tierstring · enumOptional

Select the analytics tier to query. Use edge for edge-only analytics. Default is all.

Default: allPossible values:
fromstring · date-timeRequired

Start timestamp (inclusive) of the analytics query range.

Example: 2024-11-12 00:00:00
tostring · date-timeRequired

End timestamp (inclusive) of the analytics query range.

Example: 2024-11-12 23:59:59
timezonestring · nullableOptional

Time zone used to interpret the query time range (for example, Europe/Istanbul).

limitinteger · nullableOptional

Maximum number of items to return.

pageinteger · nullableOptional

Page number for paginated results. Default is 1.

Default: 1
Responses
200

Successful Response

application/json
anyOptional
post/api/v1/overview_report/errors
POST /api/v1/overview_report/errors HTTP/1.1
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 155

{
  "organization_uuid": "text",
  "resources": [
    "text"
  ],
  "tier": "all",
  "from": "2024-11-12 00:00:00",
  "to": "2024-11-12 23:59:59",
  "timezone": "text",
  "limit": 1,
  "page": 1
}
No content

Analytics Overview Visitors Countries

post

Retrieve a country breakdown of visitors for your CDN resources within a specified time range.

Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Body
organization_uuidstringRequired

Unique identifier of the organization in the Medianova Control Panel.

resourcesstring[] · nullableOptional

List of resource UUIDs to include. Use null to include all resources.

tierstring · enumOptional

Select the analytics tier to query. Use edge for edge-only analytics. Default is all.

Default: allPossible values:
fromstring · date-timeRequired

Start timestamp (inclusive) of the analytics query range.

Example: 2024-11-12 00:00:00
tostring · date-timeRequired

End timestamp (inclusive) of the analytics query range.

Example: 2024-11-12 23:59:59
timezonestring · nullableOptional

Time zone used to interpret the query time range (for example, Europe/Istanbul).

limitinteger · nullableOptional

Maximum number of items to return.

pageinteger · nullableOptional

Page number for paginated results. Default is 1.

Default: 1
Responses
200

Successful Response

application/json
anyOptional
post/api/v1/overview_report/visitors_countries
POST /api/v1/overview_report/visitors_countries HTTP/1.1
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 155

{
  "organization_uuid": "text",
  "resources": [
    "text"
  ],
  "tier": "all",
  "from": "2024-11-12 00:00:00",
  "to": "2024-11-12 23:59:59",
  "timezone": "text",
  "limit": 1,
  "page": 1
}
No content

Analytics Overview Active Type

post

Retrieve active analytics metrics grouped by the specified type for your CDN resources within a selected time range.

Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Body
organization_uuidstringRequired

Unique identifier of the organization in the Medianova Control Panel.

resourcesstring[] · nullableOptional

List of resource UUIDs to include. Use null to include all resources.

tierstring · enumOptional

Select the analytics tier to query. Use edge for edge-only analytics. Default is all.

Default: allPossible values:
fromstring · date-timeRequired

Start timestamp (inclusive) of the analytics query range.

Example: 2024-11-12 00:00:00
tostring · date-timeRequired

End timestamp (inclusive) of the analytics query range.

Example: 2024-11-12 23:59:59
timezonestring · nullableOptional

Time zone used to interpret the query time range (for example, Europe/Istanbul).

limitinteger · nullableOptional

Maximum number of items to return.

pageinteger · nullableOptional

Page number for paginated results. Default is 1.

Default: 1
Responses
200

Successful Response

application/json
anyOptional
post/api/v1/overview_report/active_{type}
POST /api/v1/overview_report/active_{type} HTTP/1.1
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 155

{
  "organization_uuid": "text",
  "resources": [
    "text"
  ],
  "tier": "all",
  "from": "2024-11-12 00:00:00",
  "to": "2024-11-12 23:59:59",
  "timezone": "text",
  "limit": 1,
  "page": 1
}
No content

Graphs

Analytics Cache Histogram Traffic

post

Retrieve a traffic histogram for the selected cache type within a specified time range.

Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Path parameters
cache_typestringRequired

Cache type to query.

Body
organization_uuidstringRequired

Unique identifier of the organization in the Medianova Control Panel.

resourcesstring[] · nullableOptional

List of resource UUIDs to include. Use null to include all resources.

tierstring · enumOptional

Select the analytics tier to query. Use edge for edge-only analytics. Default is all.

Default: allPossible values:
fromstring · date-timeRequired

Start timestamp (inclusive) of the analytics query range.

Example: 2024-11-12 00:00:00
tostring · date-timeRequired

End timestamp (inclusive) of the analytics query range.

Example: 2024-11-12 23:59:59
timezonestring · nullableOptional

Time zone used to interpret the query time range (for example, Europe/Istanbul).

intervalstring · nullableOptional

Histogram interval (for example, 5m, 1h).

Responses
200

Successful Response

application/json
anyOptional
post/api/v1/{cache_type}_traffic_report/graph
POST /api/v1/{cache_type}_traffic_report/graph HTTP/1.1
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 154

{
  "organization_uuid": "text",
  "resources": [
    "text"
  ],
  "tier": "all",
  "from": "2024-11-12 00:00:00",
  "to": "2024-11-12 23:59:59",
  "timezone": "text",
  "interval": "text"
}
No content

Analytics Histogram

post

Retrieve a histogram time series for the selected analytics metric within a specified time range.

Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Path parameters
typestring · enumRequired

Histogram metric type to query.

Possible values:
Body
organization_uuidstringRequired

Unique identifier of the organization in the Medianova Control Panel.

resourcesstring[] · nullableOptional

List of resource UUIDs to include. Use null to include all resources.

tierstring · enumOptional

Select the analytics tier to query. Use edge for edge-only analytics. Default is all.

Default: allPossible values:
fromstring · date-timeRequired

Start timestamp (inclusive) of the analytics query range.

Example: 2024-11-12 00:00:00
tostring · date-timeRequired

End timestamp (inclusive) of the analytics query range.

Example: 2024-11-12 23:59:59
timezonestring · nullableOptional

Time zone used to interpret the query time range (for example, Europe/Istanbul).

intervalstring · nullableOptional

Histogram interval (for example, 5m, 1h).

Responses
200

Successful Response

application/json
anyOptional
post/api/v1/{type}_report/graph
POST /api/v1/{type}_report/graph HTTP/1.1
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 154

{
  "organization_uuid": "text",
  "resources": [
    "text"
  ],
  "tier": "all",
  "from": "2024-11-12 00:00:00",
  "to": "2024-11-12 23:59:59",
  "timezone": "text",
  "interval": "text"
}
No content

Analytics Histogram Status Code

post

Retrieve a histogram time series for the specified HTTP status code within a selected time range.

Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Path parameters
status_codestringRequired

HTTP status code to query (for example, 200, 404, 500).

Body
organization_uuidstringRequired

Unique identifier of the organization in the Medianova Control Panel.

resourcesstring[] · nullableOptional

List of resource UUIDs to include. Use null to include all resources.

tierstring · enumOptional

Select the analytics tier to query. Use edge for edge-only analytics. Default is all.

Default: allPossible values:
fromstring · date-timeRequired

Start timestamp (inclusive) of the analytics query range.

Example: 2024-11-12 00:00:00
tostring · date-timeRequired

End timestamp (inclusive) of the analytics query range.

Example: 2024-11-12 23:59:59
timezonestring · nullableOptional

Time zone used to interpret the query time range (for example, Europe/Istanbul).

intervalstring · nullableOptional

Histogram interval (for example, 5m, 1h).

Responses
200

Successful Response

application/json
anyOptional
post/api/v1/status_report/graph/{status_code}
POST /api/v1/status_report/graph/{status_code} HTTP/1.1
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 154

{
  "organization_uuid": "text",
  "resources": [
    "text"
  ],
  "tier": "all",
  "from": "2024-11-12 00:00:00",
  "to": "2024-11-12 23:59:59",
  "timezone": "text",
  "interval": "text"
}
No content

Analytics Histogram Domain

post
Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Path parameters
param_typestringRequired

The specific parameter type for the domain report (e.g., traffic, bandwidth).

Body
organization_uuidstringRequired

Unique identifier of the organization in the Medianova Control Panel.

resourcesstring[] · nullableOptional

List of resource UUIDs to include. Use null to include all resources.

tierstring · enumOptional

Select the analytics tier to query. Use edge for edge-only analytics. Default is all.

Default: allPossible values:
fromstring · date-timeRequired

Start timestamp (inclusive) of the analytics query range.

Example: 2024-11-12 00:00:00
tostring · date-timeRequired

End timestamp (inclusive) of the analytics query range.

Example: 2024-11-12 23:59:59
timezonestring · nullableOptional

Time zone used to interpret the query time range (for example, Europe/Istanbul).

intervalstring · nullableOptional

Histogram interval (for example, 5m, 1h).

Responses
200

Successful Response

application/json
anyOptional
post/api/v2/domain_report_{param_type}/graph
POST /api/v2/domain_report_{param_type}/graph HTTP/1.1
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 154

{
  "organization_uuid": "text",
  "resources": [
    "text"
  ],
  "tier": "all",
  "from": "2024-11-12 00:00:00",
  "to": "2024-11-12 23:59:59",
  "timezone": "text",
  "interval": "text"
}
No content

Detail Reports

Analytics Overview Analytics Report

post
Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Body
organization_uuidstringRequired

Unique identifier of the organization in the Medianova Control Panel.

resourcesstring[] · nullableOptional

List of resource UUIDs to include. Use null to include all resources.

tierstring · enumOptional

Select the analytics tier to query. Use edge for edge-only analytics. Default is all.

Default: allPossible values:
fromstring · date-timeRequired

Start timestamp (inclusive) of the analytics query range.

Example: 2024-11-12 00:00:00
tostring · date-timeRequired

End timestamp (inclusive) of the analytics query range.

Example: 2024-11-12 23:59:59
timezonestring · nullableOptional

Time zone used to interpret the query time range (for example, Europe/Istanbul).

Responses
200

Successful Response

application/json
anyOptional
post/api/v1/overview_report/analytics_report
POST /api/v1/overview_report/analytics_report HTTP/1.1
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 136

{
  "organization_uuid": "text",
  "resources": [
    "text"
  ],
  "tier": "all",
  "from": "2024-11-12 00:00:00",
  "to": "2024-11-12 23:59:59",
  "timezone": "text"
}
No content

Analytics Overview Error Report

post
Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Body
organization_uuidstringRequired

Unique identifier of the organization in the Medianova Control Panel.

resourcesstring[] · nullableOptional

List of resource UUIDs to include. Use null to include all resources.

tierstring · enumOptional

Select the analytics tier to query. Use edge for edge-only analytics. Default is all.

Default: allPossible values:
fromstring · date-timeRequired

Start timestamp (inclusive) of the analytics query range.

Example: 2024-11-12 00:00:00
tostring · date-timeRequired

End timestamp (inclusive) of the analytics query range.

Example: 2024-11-12 23:59:59
timezonestring · nullableOptional

Time zone used to interpret the query time range (for example, Europe/Istanbul).

Responses
200

Successful Response

application/json
anyOptional
post/api/v1/overview_report/error_report
POST /api/v1/overview_report/error_report HTTP/1.1
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 136

{
  "organization_uuid": "text",
  "resources": [
    "text"
  ],
  "tier": "all",
  "from": "2024-11-12 00:00:00",
  "to": "2024-11-12 23:59:59",
  "timezone": "text"
}
No content

Analytics Overview Gpu Report

post
Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Body
organization_uuidstringRequired

Unique identifier of the organization in the Medianova Control Panel.

resourcesstring[] · nullableOptional

List of resource UUIDs to include. Use null to include all resources.

tierstring · enumOptional

Select the analytics tier to query. Use edge for edge-only analytics. Default is all.

Default: allPossible values:
fromstring · date-timeRequired

Start timestamp (inclusive) of the analytics query range.

Example: 2024-11-12 00:00:00
tostring · date-timeRequired

End timestamp (inclusive) of the analytics query range.

Example: 2024-11-12 23:59:59
timezonestring · nullableOptional

Time zone used to interpret the query time range (for example, Europe/Istanbul).

Responses
200

Successful Response

application/json
anyOptional
post/api/v1/overview_report/gpu_report
POST /api/v1/overview_report/gpu_report HTTP/1.1
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 136

{
  "organization_uuid": "text",
  "resources": [
    "text"
  ],
  "tier": "all",
  "from": "2024-11-12 00:00:00",
  "to": "2024-11-12 23:59:59",
  "timezone": "text"
}
No content

Traffic Report Detail

post

Retrieve detailed traffic analytics for your CDN resources within a specified time range.

Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Body
organization_uuidstringRequired

Unique identifier of the organization in the Medianova Control Panel.

resourcesstring[] · nullableOptional

List of resource UUIDs to include. Use null to include all resources.

tierstring · enumOptional

Select the analytics tier to query. Use edge for edge-only analytics. Default is all.

Default: allPossible values:
fromstring · date-timeRequired

Start timestamp (inclusive) of the analytics query range.

Example: 2024-11-12 00:00:00
tostring · date-timeRequired

End timestamp (inclusive) of the analytics query range.

Example: 2024-11-12 23:59:59
timezonestring · nullableOptional

Time zone used to interpret the query time range (for example, Europe/Istanbul).

Responses
200

Successful Response

application/json
anyOptional
post/api/v1/traffic_report/detail
POST /api/v1/traffic_report/detail HTTP/1.1
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 136

{
  "organization_uuid": "text",
  "resources": [
    "text"
  ],
  "tier": "all",
  "from": "2024-11-12 00:00:00",
  "to": "2024-11-12 23:59:59",
  "timezone": "text"
}
No content

Requests Report Detail

post

Retrieve detailed request analytics for your CDN resources within a specified time range.

Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Body
organization_uuidstringRequired

Unique identifier of the organization in the Medianova Control Panel.

resourcesstring[] · nullableOptional

List of resource UUIDs to include. Use null to include all resources.

tierstring · enumOptional

Select the analytics tier to query. Use edge for edge-only analytics. Default is all.

Default: allPossible values:
fromstring · date-timeRequired

Start timestamp (inclusive) of the analytics query range.

Example: 2024-11-12 00:00:00
tostring · date-timeRequired

End timestamp (inclusive) of the analytics query range.

Example: 2024-11-12 23:59:59
timezonestring · nullableOptional

Time zone used to interpret the query time range (for example, Europe/Istanbul).

Responses
200

Successful Response

application/json
anyOptional
post/api/v1/requests_report/detail
POST /api/v1/requests_report/detail HTTP/1.1
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 136

{
  "organization_uuid": "text",
  "resources": [
    "text"
  ],
  "tier": "all",
  "from": "2024-11-12 00:00:00",
  "to": "2024-11-12 23:59:59",
  "timezone": "text"
}
No content

Errors

Error Logs Status Codes

post

List error log entries grouped by HTTP status codes for the selected time range.

Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Query parameters
pageintegerOptional

Page number for paginated results. Default is 1.

Default: 1
Body
organization_uuidstringRequired

Unique identifier of the organization in the Medianova Control Panel.

resourcesstring[] · nullableOptional

List of resource UUIDs to include. Use null to include all resources.

tierstring · enumOptional

Select the analytics tier to query. Use edge for edge-only analytics. Default is all.

Default: allPossible values:
fromstring · date-timeRequired

Start timestamp (inclusive) of the analytics query range.

Example: 2024-11-12 00:00:00
tostring · date-timeRequired

End timestamp (inclusive) of the analytics query range.

Example: 2024-11-12 23:59:59
timezonestring · nullableOptional

Time zone used to interpret the query time range (for example, Europe/Istanbul).

page_sizeinteger · nullableOptional

Number of items to return per page.

statusCodesinteger[]Optional

List of HTTP status codes to filter on.

Responses
200

Successful Response

application/json
anyOptional
post/api/v1/error_logs/status_codes
POST /api/v1/error_logs/status_codes HTTP/1.1
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 168

{
  "organization_uuid": "text",
  "resources": [
    "text"
  ],
  "tier": "all",
  "from": "2024-11-12 00:00:00",
  "to": "2024-11-12 23:59:59",
  "timezone": "text",
  "page_size": 1,
  "statusCodes": [
    1
  ]
}
No content

Error Report Status Codes

post

Retrieve an HTTP status code breakdown for your CDN resources within a specified time range.

Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Body
organization_uuidstringRequired

Unique identifier of the organization in the Medianova Control Panel.

resourcesstring[] · nullableOptional

List of resource UUIDs to include. Use null to include all resources.

tierstring · enumOptional

Select the analytics tier to query. Use edge for edge-only analytics. Default is all.

Default: allPossible values:
fromstring · date-timeRequired

Start timestamp (inclusive) of the analytics query range.

Example: 2024-11-12 00:00:00
tostring · date-timeRequired

End timestamp (inclusive) of the analytics query range.

Example: 2024-11-12 23:59:59
timezonestring · nullableOptional

Time zone used to interpret the query time range (for example, Europe/Istanbul).

Responses
200

Successful Response

application/json
anyOptional
post/api/v1/error_report/status_codes
POST /api/v1/error_report/status_codes HTTP/1.1
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 136

{
  "organization_uuid": "text",
  "resources": [
    "text"
  ],
  "tier": "all",
  "from": "2024-11-12 00:00:00",
  "to": "2024-11-12 23:59:59",
  "timezone": "text"
}
No content

Regions

Analytics Overview Region

post

Retrieve regional analytics for your CDN resources within a specified time range.

Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Body
organization_uuidstringRequired

Unique identifier of the organization in the Medianova Control Panel.

resourcesstring[] · nullableOptional

List of resource UUIDs to include. Use null to include all resources.

fromstring · date-timeRequired

Start timestamp (inclusive) of the analytics query range.

Example: 2024-11-12 00:00:00
tostring · date-timeRequired

End timestamp (inclusive) of the analytics query range.

Example: 2024-11-12 23:59:59
timezonestring · nullableOptional

Time zone used to interpret the query time range (for example, Europe/Istanbul).

Responses
200

Successful Response

application/json
anyOptional
post/api/v1/overview_report/region
POST /api/v1/overview_report/region HTTP/1.1
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 123

{
  "organization_uuid": "text",
  "resources": [
    "text"
  ],
  "from": "2024-11-12 00:00:00",
  "to": "2024-11-12 23:59:59",
  "timezone": "text"
}
No content

Analytics Overview Region Billing

post

Retrieve region-based billing analytics for your CDN resources within a specified time range.

Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Body
organization_uuidstringRequired

Unique identifier of the organization in the Medianova Control Panel.

resourcesstring[] · nullableOptional

List of resource UUIDs to include. Use null to include all resources.

fromstring · date-timeRequired

Start timestamp (inclusive) of the analytics query range.

Example: 2024-11-12 00:00:00
tostring · date-timeRequired

End timestamp (inclusive) of the analytics query range.

Example: 2024-11-12 23:59:59
timezonestring · nullableOptional

Time zone used to interpret the query time range (for example, Europe/Istanbul).

Responses
200

Successful Response

application/json
anyOptional
post/api/v1/overview_report/region_billing
POST /api/v1/overview_report/region_billing HTTP/1.1
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 123

{
  "organization_uuid": "text",
  "resources": [
    "text"
  ],
  "from": "2024-11-12 00:00:00",
  "to": "2024-11-12 23:59:59",
  "timezone": "text"
}
No content

GPU

GPU Stat Details

post

Retrieve GPU processing statistics for your CDN resources within a specified time range.

Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Body
organization_uuidstringRequired

Unique identifier of the organization in the Medianova Control Panel.

resourcesstring[] · nullableOptional

List of resource UUIDs to include. Use null to include all resources.

fromstring · date-timeRequired

Start timestamp (inclusive) of the analytics query range.

Example: 2024-11-12 00:00:00
tostring · date-timeRequired

End timestamp (inclusive) of the analytics query range.

Example: 2024-11-12 23:59:59
timezonestring · nullableOptional

Time zone used to interpret the query time range (for example, Europe/Istanbul).

agg_typestring · enumOptional

Aggregation type for grouping results.

Default: formatPossible values:
io_process_filterany of · nullableOptional

I/O process filter. Use all to include all values.

Default: all
stringOptional
or
string[]Optional
format_filterany of · nullableOptional

Format filter. Use all to include all values.

Default: all
stringOptional
or
string[]Optional
Responses
200

Successful Response

application/json
anyOptional
post/api/v1/overview_report/gpu_stat_details
POST /api/v1/overview_report/gpu_stat_details HTTP/1.1
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 191

{
  "organization_uuid": "text",
  "resources": [
    "text"
  ],
  "from": "2024-11-12 00:00:00",
  "to": "2024-11-12 23:59:59",
  "timezone": "text",
  "agg_type": "format",
  "io_process_filter": "all",
  "format_filter": "all"
}
No content

GPU Histogram Details

post

Retrieve a GPU histogram time series for your CDN resources within a specified time range.

Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Body
organization_uuidstringRequired

Unique identifier of the organization in the Medianova Control Panel.

resourcesstring[] · nullableOptional

List of resource UUIDs to include. Use null to include all resources.

fromstring · date-timeRequired

Start timestamp (inclusive) of the analytics query range.

Example: 2024-11-12 00:00:00
tostring · date-timeRequired

End timestamp (inclusive) of the analytics query range.

Example: 2024-11-12 23:59:59
timezonestring · nullableOptional

Time zone used to interpret the query time range (for example, Europe/Istanbul).

intervalstring · nullableOptional

Histogram interval (for example, 5m, 1h).

Responses
200

Successful Response

application/json
anyOptional
post/api/v1/overview_report/gpu_histogram_details
POST /api/v1/overview_report/gpu_histogram_details HTTP/1.1
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 141

{
  "organization_uuid": "text",
  "resources": [
    "text"
  ],
  "from": "2024-11-12 00:00:00",
  "to": "2024-11-12 23:59:59",
  "timezone": "text",
  "interval": "text"
}
No content

Storage Stat Details

post
Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Body
organization_uuidstringRequired

Unique identifier of the organization in the Medianova Control Panel.

resourcesstring[] · nullableOptional

List of resource UUIDs to include. Use null to include all resources.

fromstring · date-timeRequired

Start timestamp (inclusive) of the analytics query range.

Example: 2024-11-12 00:00:00
tostring · date-timeRequired

End timestamp (inclusive) of the analytics query range.

Example: 2024-11-12 23:59:59
timezonestring · nullableOptional

Time zone used to interpret the query time range (for example, Europe/Istanbul).

Responses
200

Successful Response

application/json
anyOptional
post/api/v1/storage_report/detail
POST /api/v1/storage_report/detail HTTP/1.1
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 123

{
  "organization_uuid": "text",
  "resources": [
    "text"
  ],
  "from": "2024-11-12 00:00:00",
  "to": "2024-11-12 23:59:59",
  "timezone": "text"
}
No content

Traffic & Bandwidth

Analytics Histogram Traffic

post

Retrieve a traffic histogram time series for your CDN resources within a specified time range.

Body
organization_uuidstringRequired

The unique identifier of the organization.

resourcesstring[] · nullableOptional

List of resource UUIDs to include. If omitted or null, the response includes all resources in the organization.

tierstring · enumOptional

Select the analytics tier to query. Use edge for edge-only analytics. Default is all.

Default: allPossible values:
fromstring · date-timeRequired

Start timestamp (inclusive) of the query range.

Example: 2024-11-12 00:00:00
tostring · date-timeRequired

End timestamp (inclusive) of the query range.

Example: 2024-11-12 23:59:59
timezonestring · nullableOptional

Time zone used to interpret and group the query time range (for example, Europe/Istanbul).

intervalstring · nullableOptional

Aggregation interval for the histogram (for example, 5m, 10m, 1h).

Responses
200

Successful Response

statusbooleanRequired

Indicates whether the request was processed successfully.

post/api/v1/traffic_report/graph
POST /api/v1/traffic_report/graph HTTP/1.1
Content-Type: application/json
Accept: */*
Content-Length: 191

{
  "organization_uuid": "<ORGANIZATION_UUID>",
  "resources": [
    "<RESOURCE_UUID_1>"
  ],
  "tier": "all",
  "from": "2024-11-12 00:00:00",
  "to": "2024-11-12 23:59:59",
  "timezone": "Europe/Istanbul",
  "interval": "5m"
}
{
  "status": true,
  "data": {
    "progressive": [
      {
        "time": 1731369600,
        "traffic": 123456,
        "traffic_formatted": "120.56 KB"
      }
    ],
    "stream": [
      {
        "time": 1731369600,
        "traffic": 123456,
        "traffic_formatted": "120.56 KB"
      }
    ]
  }
}

Analytics Histogram Bandwidth

post

Retrieve a bandwidth histogram time series for your CDN resources within a specified time range.

Body
organization_uuidstringRequired

The unique identifier of the organization.

resourcesstring[] · nullableOptional

List of resource UUIDs to include. If omitted or null, the response includes all resources in the organization.

tierstring · enumOptional

Select the analytics tier to query. Use edge for edge-only analytics. Default is all.

Default: allPossible values:
fromstring · date-timeRequired

Start timestamp (inclusive) of the query range.

Example: 2024-11-12 00:00:00
tostring · date-timeRequired

End timestamp (inclusive) of the query range.

Example: 2024-11-12 23:59:59
timezonestring · nullableOptional

Time zone used to interpret and group the query time range (for example, Europe/Istanbul).

intervalstring · nullableOptional

Aggregation interval for the histogram (for example, 5m, 10m, 1h).

Responses
200

Successful Response

statusbooleanRequired

Indicates whether the request was processed successfully.

post/api/v1/bandwidth_report/graph
POST /api/v1/bandwidth_report/graph HTTP/1.1
Content-Type: application/json
Accept: */*
Content-Length: 191

{
  "organization_uuid": "<ORGANIZATION_UUID>",
  "resources": [
    "<RESOURCE_UUID_1>"
  ],
  "tier": "all",
  "from": "2024-11-12 00:00:00",
  "to": "2024-11-12 23:59:59",
  "timezone": "Europe/Istanbul",
  "interval": "5m"
}
{
  "status": true,
  "data": {
    "progressive": [
      {
        "time": 1731369600,
        "bandwidth": 987654,
        "bandwidth_formatted": "964.50 KB/s"
      }
    ],
    "stream": [
      {
        "time": 1731369600,
        "bandwidth": 987654,
        "bandwidth_formatted": "964.50 KB/s"
      }
    ]
  }
}
PreviousPaths
NextWAF Analytics

Last updated

Was this helpful?