/bff/iot-lock/activity-timeline

Unified time-ordered feed of everything that has happened with a given lock: unlock attempts, TTLock API calls (failed only), passcode operations (create / delete), gateway online/offline transitions, battery readings, and system log entries scoped to TTLock components. Powers the Activity log tab on the lock detail page. Result is paginated; default window is the last 7 days.

IoTgetBffIot-lockActivity-timeline

Parameters

7 query

Query parameters

· 7

lockIdstringRequired

TTLock lock ID (from TTLock API).

Example12345

sincestringOptional

ISO timestamp. Defaults to 7 days ago.

Exampleexample_since

untilstringOptional

ISO timestamp. Defaults to now.

Exampleexample_until

kindsstringOptional

Comma-separated activity kinds. One of: unlock_attempt, api_call, passcode_op, gateway_event, battery_event, system_log.

Exampleexample_kinds

levelsstringOptional

Comma-separated severity levels. One of: info, success, error, warning, critical.

Exampleexample_levels

limitstringOptional

Page size, default 100, max 500.

Exampleexample_limit

offsetstringOptional

Offset for pagination, default 0.

Exampleexample_offset

Response schema

1 status code documented

200Success

This response returns no JSON body.

Response example

application/json

{
  "success": true
}

Request example

GET /bff/iot-lock/activity-timeline

get

curl -X GET "https://api.bizkithub.com/bff/iot-lock/activity-timeline?lockId=12345&since=example_since&until=example_until&kinds=example_kinds&levels=example_levels&limit=example_limit&offset=example_offset" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY"

Need an API key?

All BizKitHub public API endpoints require authentication via API key.

Get API Key