Contadores diarios de uso de una zona, tal y como los cuenta el borde.
| Operación | Ruta |
|---|---|
| Ver el uso de la zona | GET /v1/orgs/{org}/zones/{zone}/usage |
Ver el uso de la zona
GET /v1/orgs/{org}/zones/{zone}/usageDevuelve los contadores de uso diarios de la zona, peticiones, peticiones bloqueadas, bytes y consultas DNS, por defecto de los últimos 30 días.
Rol necesario: readonly o superior.
Parámetros
| Nombre | En | Tipo | Obligatorio | Descripción |
|---|---|---|---|---|
org | ruta | string (uuid) | Sí | Id de la organización. Cada ruta comprueba que es la del token (si no, 404). |
zone | ruta | string (uuid) | Sí | Id de la zona (consulta Listar zonas). |
from | consulta | string (date) | No | Primer día (UTC). Por defecto, hace 30 días. |
to | consulta | string (date) | No | Último día (UTC). Por defecto, hoy. |
Respuesta
200: Devuelveitems, un array de Usage.
| Campo | Tipo | Descripción |
|---|---|---|
items[].zone_id | string (uuid) | Id de la zona. |
items[].day | string (date) | Día (UTC). |
items[].requests | integer | Peticiones. |
items[].bytes_in | integer | Bytes recibidos de los visitantes. |
items[].bytes_out | integer | Bytes enviados a los visitantes. |
items[].blocked_requests | integer | Peticiones bloqueadas. |
items[].dns_queries | integer | Consultas DNS respondidas. |
Ejemplo
curl "https://dash.openwaf.dev/v1/orgs/$OPENWAF_ORG/zones/6f1d2c3b-8a4e-4b7d-9c21-5e3f7a8b9c0d/usage?from=2026-10-01&to=2026-10-27" \
-H "Authorization: Bearer $OPENWAF_TOKEN"import { OpenWAF } from "./openwaf";
const owf = new OpenWAF({ baseUrl: "https://dash.openwaf.dev" }); // token de OPENWAF_TOKEN
const result = await owf.getZoneUsage({
zone: "6f1d2c3b-8a4e-4b7d-9c21-5e3f7a8b9c0d",
from: "2026-10-01",
to: "2026-10-27"
});from openwaf import OpenWAF
owf = OpenWAF(base_url="https://dash.openwaf.dev") # token de OPENWAF_TOKEN
result = owf.get_zone_usage(
zone="6f1d2c3b-8a4e-4b7d-9c21-5e3f7a8b9c0d",
from_="2026-10-01",
to="2026-10-27",
)200
{
"items": [
{
"zone_id": "6f1d2c3b-8a4e-4b7d-9c21-5e3f7a8b9c0d",
"day": "2026-10-26",
"requests": 182340,
"bytes_in": 41230512,
"bytes_out": 2318823104,
"blocked_requests": 1204,
"dns_queries": 95210
}
]
}