smoxy

English

Deutsch

English

Deutsch

Appearance

Retrieves a zone-kpis resource.​

GET
/api/zones/{zoneId}/traffic-chart

Retrieves a zone-kpis resource.

Authorizations​

ApiToken

Long-lived API token created via POST /api/api-tokens (returned once in plaintext).

Type
API Key (header: X-API-TOKEN)
or
JWT

JWT access token obtained via POST /api/auth/login. Send as: Authorization: Bearer .

Type
HTTP (bearer)

Parameters​

Path Parameters

zoneId*

Zone identifier

Type
string
Required

Query Parameters

metric*

The traffic metric to chart. Use "top" for a ranked breakdown (see dimension/limit).

Type
string
Required
Valid values
"access""status-codes""image-cache""html-cache""content-type""cache-purges""blocked""top"
dimension

metric=top: which column to rank. Ignored for other metrics.

Type
string
Valid values
"host""country""status""uri"
limit

metric=top: number of rows to return (default 8, max 100).

Type
integer
Minimum
1
Maximum
100
Default
8
range

Preset time range. Ignored when from/to are provided.

Type
string
Valid values
"5 minutes""15 minutes""1 hour""6 hours""1 day""3 days""7 days""30 days"
Default
"1 hour"
from

Custom range start (Unix timestamp in seconds).

Type
integer
to

Custom range end (Unix timestamp in seconds).

Type
integer
points

Number of data points (buckets). Auto-calculated when omitted.

Type
integer
Minimum
1
Maximum
100
host

Only count requests for this exact host.

Type
string
status_code

Only count requests with this exact HTTP status code.

Type
integer
q

Free-text filter: case-insensitive substring match over host, URI, client IP and request id.

Type
string

Responses​

zone-kpis resource

JSON
{
  
"@context": "string",
  
"@id": "string",
  
"@type": "string",
  
"metric": "string",
  
"series": {
  
  
"additionalProperties": [
  
  
  
[
  
  
  
]
  
  
]
  
},
  
"range": "string",
  
"from": "string",
  
"to": "string",
  
"items": [
  
  
{
  
  
  
"additionalProperties": 0
  
  
}
  
],
  
"dimension": "string"
}

Playground​

Authorization
Variables
Key
Value

Samples​

Powered by VitePress OpenAPI