test: Update API collection for rating system changes
- Update rating examples to use 1-10 scale - Document half-star precision in API collections - Add rating conversion examples for testing - Update Get Ebook Rating docs with scale explanation - Update Create/Update Rating with new validation rules
This commit is contained in:
@@ -12,7 +12,7 @@ post {
|
||||
|
||||
body:json {
|
||||
{
|
||||
"rating": 4
|
||||
"rating": 7
|
||||
}
|
||||
}
|
||||
|
||||
@@ -32,18 +32,24 @@ docs {
|
||||
- `id` (string): Ebook UUID
|
||||
|
||||
**Request Body:**
|
||||
- `rating` (number, required): Rating value (1-5)
|
||||
- `rating` (number, required): Rating value (1-10, where odd numbers = half-stars)
|
||||
- 1,3,5,7,9 = 0.5,1.5,2.5,3.5,4.5 stars (half-star precision)
|
||||
- 2,4,6,8,10 = 1,2,3,4,5 stars (full stars)
|
||||
|
||||
**Example Request:**
|
||||
- `"rating": 7` = 3.5 stars (frontend display)
|
||||
- `"rating": 8` = 4.0 stars (frontend display)
|
||||
|
||||
**Response:**
|
||||
- `id` (string): Rating UUID
|
||||
- `ebook_id` (string): Ebook UUID
|
||||
- `user_id` (string): User UUID
|
||||
- `rating` (number): Rating value (1-5)
|
||||
- `rating` (number): Rating value (1-10)
|
||||
- `created_at` (string): Creation timestamp
|
||||
- `updated_at` (string): Last update timestamp
|
||||
|
||||
**Error Responses:**
|
||||
- 400: Invalid rating value
|
||||
- 400: Invalid rating value (must be 1-10)
|
||||
- 401: Invalid authentication
|
||||
- 404: Ebook not found
|
||||
}
|
||||
|
||||
Reference in New Issue
Block a user