/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

7 total

Query · 7

lockIdstringRequired

TTLock lock ID (from TTLock API).

sincestring

ISO timestamp. Defaults to 7 days ago.

untilstring

ISO timestamp. Defaults to now.

kindsstring

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

levelsstring

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

limitstring

Page size, default 100, max 500.

offsetstring

Offset for pagination, default 0.

Request

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"

Response

JSON payload

{
  "success": true
}

All response codes

1 status code documented

Need an API key?

All BizKitHub API endpoints require authentication via API key.

Get API Key