54 lines
1.4 KiB
YAML
54 lines
1.4 KiB
YAML
info:
|
|
name: Update Media Rating
|
|
type: http
|
|
seq: 1
|
|
http:
|
|
method: PUT
|
|
url: '{{base_url}}/api/media-items/{{media_item_id}}/rating'
|
|
auth: inherit
|
|
body:
|
|
type: json
|
|
jsonBody: "{\n \"rating\": 4,\n \"review\": \"Great book! Very enjoyable\
|
|
\ read.\""
|
|
headers:
|
|
- key: Content-Type
|
|
value: application/json
|
|
runtime:
|
|
scripts:
|
|
- type: tests
|
|
code: "test_update_media_rating_success(status, headers, body) {\n if (status\
|
|
\ !== 200) {\n throw new Error(\"Expected status 200, got \" + status);"
|
|
|
|
docs: |-
|
|
## Update Media Rating
|
|
|
|
Updates an existing rating for a media item.
|
|
|
|
**Method:** PUT
|
|
|
|
**Endpoint:** /api/media-items/:id/rating
|
|
|
|
**Authentication:** Required (Bearer token)
|
|
|
|
**Path Parameters:**
|
|
- `id` (string, required): Media item UUID
|
|
|
|
**Request Body:**
|
|
- `rating` (number, required): Rating value (typically 1-5)
|
|
- `review` (string, optional): Review text
|
|
|
|
**Response:** Updated rating object
|
|
- `id` (string): Rating ID
|
|
- `media_item_id` (string): Media item UUID
|
|
- `rating` (number): Rating value
|
|
- `review` (string): Review text
|
|
- `created_at` (string): Creation timestamp
|
|
- `updated_at` (string): Last update timestamp
|
|
|
|
**Status Codes:**
|
|
- 200: Success
|
|
- 400: Invalid request body
|
|
- 401: Unauthorized
|
|
- 404: Media item or rating not found
|
|
- 500: Internal server error
|