Returns aggregated activity timeline for a device
GET /api/history/device/{mac}/timeline
Auto-generated from server.go. Handler: s.getDeviceTimeline.
Authorizations
Section titled “Authorizations ”Parameters
Section titled “ Parameters ”Path Parameters
Section titled “Path Parameters ”Example
aa:bb:cc:dd:ee:ffFull MAC address with colon or hyphen separators.
Responses
Section titled “ Responses ”Successful response
Returns aggregated activity timeline for a device.
Schema hand-corrected in Session 10. The Session-6 lift sampled a row
with only ACK / REQUEST in stats and mean as an integer; the handler
actually emits an unbounded map[string]StatItem (DISCOVER, REQUEST,
OFFER, ACK, NAK, RELEASE, INFORM… any DHCPv4/v6 message type), and
mean is float64 not int. Switch stats.properties to
additionalProperties and retype mean.
object
object
RFC3339 string emitted by handler time.Time.Format; not time.Time.
RFC3339 string emitted by handler time.Time.Format; not time.Time.
object
Per-message-type statistics over the time range. Keys are DHCP message type names (DISCOVER, OFFER, REQUEST, ACK, NAK, RELEASE, INFORM, DECLINE — and DHCPv6 SOLICIT, REQUEST, RENEW, etc). Whatever message types appeared in the window are present; others are omitted.
object
object
Float; computed as sum/count. The Session-6 lift sampled integer values and typed it as integer which is wrong.
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.
The requested resource was not found.
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.