Returns devices currently blocked by nftables rate limiting. Uses reverse MAC lookup from 32-bit marks
GET /api/blocked-devices
Auto-generated from server.go. Handler: s.getBlockedDevices.
Authorizations
Section titled “Authorizations ”Responses
Section titled “ Responses ”Successful response
Returns devices currently blocked by nftables rate limiting. Uses reverse MAC lookup from 32-bit marks.
Schema hand-corrected in Session 9 from the 70-03a auto-lift artifact: added
missing handler fields (client_duid, hostname, all_matches), retyped time
fields as plain strings (handler emits RFC3339 strings, not typed time
objects), relaxed data required-list to handler’s actual non-omitempty
fields, widened stats.avg_remaining_seconds from int to number (float64),
and widened chart_data[].sets from a single rigid key to additionalProperties:
integer (Go emits map[string]int over all FirewallDecisionSets).
object
object
RFC3339 timestamp (handler emits string, not date-time-typed object)
RFC3339 timestamp (handler emits string)
A possible MAC address or DUID match for an nftables mark. Mirrors processor.MACMatch (internal/processor/nft_cache.go). Used in GetBlockedDevicesResponse.data[].all_matches.
object
RFC3339 timestamp.
object
object
Float64 average; not integer.
object
object
Map of nftables set name -> count for this time bucket. Keys are dynamic (one of FirewallDecisionSets).
object
Authentication is required or the supplied token is invalid.
Standardised error envelope per RFC 7807. Many existing endpoints still
return an older shape (e.g. {"error": "..."}). This schema documents the
target shape; legacy endpoints will be migrated in Phase 70. Per D-21 the
spec describes current behaviour without enforcing the migration here.
object
A URI reference that identifies the problem type.
A short human-readable summary of the problem.
The HTTP status code generated by the origin server.
A human-readable explanation specific to this occurrence.
A URI reference that identifies the specific occurrence.
Legacy error message field. Will be removed once handlers are migrated.
Legacy per-field error details. Will be removed once handlers are migrated.
object
The request id middleware-assigned identifier for tracing.
Internal server error
Standardised error envelope per RFC 7807. Many existing endpoints still
return an older shape (e.g. {"error": "..."}). This schema documents the
target shape; legacy endpoints will be migrated in Phase 70. Per D-21 the
spec describes current behaviour without enforcing the migration here.
object
A URI reference that identifies the problem type.
A short human-readable summary of the problem.
The HTTP status code generated by the origin server.
A human-readable explanation specific to this occurrence.
A URI reference that identifies the specific occurrence.
Legacy error message field. Will be removed once handlers are migrated.
Legacy per-field error details. Will be removed once handlers are migrated.
object
The request id middleware-assigned identifier for tracing.