john-okeefe
3117ce54ec
- Convert all existing .bru files from JSON to Bruno DSL format - Remove obsolete files (conflicts/api.bru, kobo/Kobo Initialization.bru) - Update auth configuration to use 'inherit' instead of explicit bearer tokens - Add comprehensive documentation to all test files - Improve test scripts with proper assertions and error handling
51 lines
1.1 KiB
Plaintext
51 lines
1.1 KiB
Plaintext
meta {
|
|
name: Clear Kobo Shelf
|
|
type: http
|
|
seq: 1
|
|
}
|
|
|
|
delete {
|
|
url: {{baseURL}}/api/devices/{{deviceID}}/shelves/clear?shelf={{shelfName}}
|
|
body: none
|
|
auth: inherit
|
|
}
|
|
|
|
headers {
|
|
Authorization: Bearer {{userToken}}
|
|
}
|
|
|
|
settings {
|
|
encodeUrl: true
|
|
timeout: 0
|
|
}
|
|
|
|
docs {
|
|
## Clear Kobo Shelf
|
|
|
|
Clear all books from a Kobo device shelf, or all shelves if no shelf name is specified.
|
|
|
|
**Method:** DELETE
|
|
|
|
**Endpoint:** /api/devices/{deviceID}//shelves/clear?shelf={shelfName}
|
|
|
|
**Authentication:** Bearer token
|
|
|
|
**Path Parameters:**
|
|
- `deviceID` (string): Device UUID
|
|
|
|
**Query Parameters:**
|
|
- `shelf` (string, optional): Shelf name to clear. If omitted, clears all shelves.
|
|
|
|
**Response:**
|
|
- `message` (string): Success message
|
|
- `cleared_count` (number): Number of books removed from shelf
|
|
|
|
**Status Codes:**
|
|
- 200: Success - shelf cleared
|
|
- 401: Unauthorized
|
|
- 404: Device not found
|
|
- 500: Internal server error
|
|
|
|
**Note:** Removes all books from the specified shelf. If no shelf name is provided, clears all shelves for the device. This operation cannot be undone.
|
|
}
|