75 lines
2.2 KiB
YAML
75 lines
2.2 KiB
YAML
info:
|
|
name: List Conflicts
|
|
type: http
|
|
seq: 1
|
|
http:
|
|
method: GET
|
|
url: '{{base_url}}/api/conflicts?status=unresolved'
|
|
auth: inherit
|
|
body:
|
|
type: none
|
|
headers:
|
|
- key: Authorization
|
|
value: Bearer {{token
|
|
|
|
docs: |-
|
|
## List Conflicts
|
|
|
|
Lists all sync conflicts for the authenticated user with optional filtering.
|
|
|
|
**Method:** GET
|
|
|
|
**Endpoint:** /api/conflicts
|
|
|
|
**Authentication:** Bearer token
|
|
|
|
**Query Parameters:**
|
|
- `status` (string, optional): Filter by resolution status
|
|
- `unresolved`: Only unresolved conflicts (default)
|
|
- `user_resolved`: Conflicts resolved by user
|
|
- `auto_resolved`: Automatically resolved conflicts
|
|
- `all`: All conflicts regardless of status
|
|
- `type` (string, optional): Filter by conflict type
|
|
- `progress`: Reading progress conflicts
|
|
- `note`: Bookmark/note conflicts
|
|
- `highlight`: Highlight conflicts
|
|
|
|
**Response:**
|
|
- `conflicts` (array): Array of conflict objects
|
|
- `total` (number): Total number of conflicts matching filters
|
|
- `unresolved` (number): Number of unresolved conflicts
|
|
|
|
**Each Conflict Object:**
|
|
- `id` (string): Conflict UUID
|
|
- `media_item_id` (string): Associated book UUID
|
|
- `media_item_title` (string): Book title
|
|
- `conflict_type` (string): Type of conflict (progress, note, highlight)
|
|
- `conflict_data` (object): Side-by-side comparison of conflicting data
|
|
- `koreader`: Data from KOReader device
|
|
- `kobo`: Data from Kobo device
|
|
- `web`: Data from web interface
|
|
- `resolution_status` (string): Current status (unresolved, user_resolved, auto_resolved)
|
|
- `created_at` (string): ISO 8601 timestamp when conflict was detected
|
|
|
|
**Status Codes:**
|
|
- 200: Success
|
|
- 401: Unauthorized
|
|
- 500: Internal server error
|
|
|
|
**Example Request:**
|
|
```
|
|
GET /api/conflicts?status=unresolved&type=progress
|
|
```
|
|
|
|
**Example Response:**
|
|
```json
|
|
{
|
|
"conflicts": [
|
|
{
|
|
"id": "conflict-uuid",
|
|
"media_item_id": "book-uuid",
|
|
"media_item_title": "Foundation",
|
|
"conflict_type": "progress",
|
|
"conflict_data": {
|
|
"koreader": { "percentage": 0.65, "epubcfi": "..."
|