57 lines
1.3 KiB
YAML
57 lines
1.3 KiB
YAML
info:
|
|
name: Reject Registration - KOReader
|
|
type: http
|
|
seq: 16
|
|
|
|
http:
|
|
method: POST
|
|
url: '{{base_url}}/api/devices/reject/reg-uuid-123'
|
|
auth: inherit
|
|
|
|
docs: |-
|
|
## Reject KOReader Registration
|
|
|
|
Rejects a pending KOReader device registration.
|
|
|
|
**Method:** POST
|
|
|
|
**Endpoint:** /api/devices/reject/:registration_id
|
|
|
|
**Authentication:** Required (Bearer token)
|
|
|
|
**Path Parameters:**
|
|
- `registration_id` (string): Example: `reg-uuid-123`
|
|
|
|
**Request Body:**
|
|
Optional rejection reason:
|
|
```json
|
|
{
|
|
"reason": "Device not recognized or user cancelled"
|
|
}
|
|
```
|
|
|
|
**Response:**
|
|
- `registration_id` (string): Rejected registration UUID
|
|
- `device_name` (string): KOReader device name
|
|
- `device_type` (string): `koreader`
|
|
- `status` (string): `rejected`
|
|
- `rejected_at` (string): Rejection timestamp
|
|
|
|
**Status Codes:**
|
|
- 200: Rejected successfully
|
|
- 401: Unauthorized
|
|
- 403: Forbidden
|
|
- 404: Registration not found
|
|
|
|
**KOReader Rejection Handling:**
|
|
- KOReader app displays rejection message
|
|
- User can initiate new registration
|
|
- Previous device identifier can be reused
|
|
- No data is lost on the device
|
|
|
|
**Common Reasons:**
|
|
- User didn't initiate registration
|
|
- Wrong device type selected
|
|
- Testing/sample registration
|
|
- Security concerns
|