42 lines
1.1 KiB
YAML
42 lines
1.1 KiB
YAML
info:
|
|
name: List User Devices
|
|
type: http
|
|
seq: 5
|
|
|
|
http:
|
|
method: GET
|
|
url: '{{base_url}}/api/devices'
|
|
auth: inherit
|
|
|
|
docs: |-
|
|
## List User Devices
|
|
|
|
Retrieves all registered devices for the authenticated user.
|
|
|
|
**Method:** GET
|
|
|
|
**Endpoint:** /api/devices
|
|
|
|
**Authentication:** Required (Bearer token)
|
|
|
|
**Response:**
|
|
- Array of device objects:
|
|
- `id` (string): Device UUID
|
|
- `device_name` (string): Human-readable device name
|
|
- `device_type` (string): `kobo`, `koreader`, or `web`
|
|
- `device_identifier` (string): Unique device identifier
|
|
- `sync_enabled` (boolean): Whether sync is active
|
|
- `auto_sync` (boolean): Whether automatic sync is enabled
|
|
- `sync_frequency_minutes` (integer): Sync interval in minutes
|
|
- `last_synced_at` (string): Last successful sync timestamp
|
|
- `created_at` (string): Registration timestamp
|
|
|
|
**Status Codes:**
|
|
- 200: Success
|
|
- 401: Unauthorized
|
|
|
|
**Usage:**
|
|
- Display user's devices in account settings
|
|
- Allow users to manage sync settings per device
|
|
- Show last sync time for each device
|