Files
bookhoard/bruno/ebooks/Get Ebook Rating.bru
T
john-okeefe 6ed69005b5 refactor(bruno): standardize all variables to snake_case naming convention
Standardize all Bruno environment variables to use snake_case convention
(aligned with Go naming practices) and remove duplicate camelCase variants.

Changes:
- Environment file cleanup:
  - Remove: baseUrl, ebookid, fakebookid, libraryId, mediaItemId, isVisible, refreshToken
  - Standardize: fakebookid → fake_book_id, isVisible → is_visible, refreshToken → refresh_token
  - All variables now use consistent snake_case format

- Update all Bruno requests to use standardized variables:
  - ebooks: {{ebookid}} → {{ebook_id}}
  - library: {{libraryId}} → {{library_id}}
  - media-items: {{mediaItemId}} → {{media_item_id}}
  - visibility: {{isVisible}} → {{is_visible}}
  - auth: {{refreshToken}} → {{refresh_token}}

Benefits:
- Single source of truth for each variable
- Consistent with Go naming conventions
- No ambiguity about which variable name to use
- Cleaner, more maintainable codebase
2026-01-29 10:06:00 -05:00

50 lines
1.2 KiB
Plaintext

meta {
name: Get Ebook Rating
type: http
seq: 6
}
get {
url: {{base_url}}/api/ebooks/{{ebook_id}}/rating
body: none
auth: inherit
}
settings {
encodeUrl: true
timeout: 0
}
docs {
## Get Ebook Rating
Retrieves the authenticated user's rating for a specific ebook.
**Authentication:** Required (Bearer token)
**Path Parameters:**
- `id` (string): Ebook UUID
**Response when rating exists:**
- `id` (string): Rating UUID
- `ebook_id` (string): Ebook UUID
- `user_id` (string): User UUID
- `rating` (number): Rating value (1-10, where odd numbers = half-stars)
- `created_at` (string): Creation timestamp
- `updated_at` (string): Last update timestamp
**Response when no rating exists:**
- `ebook_id` (string): Ebook UUID
- `user_id` (string): User UUID
- `rating` (number): Always 0 (indicates no rating)
**Error Responses:**
- 401: Invalid authentication
**Rating System:**
- Backend: 1-10 scale (odd numbers = half-stars: 1,3,5,7,9)
- Frontend: 1-5 stars with half-star precision (0.5, 1.5, 2.5, 3.5, 4.5)
- Example: Backend rating 3 = Frontend display 1.5 stars
**Note:** This endpoint returns HTTP 200 with rating 0 when no rating exists, instead of HTTP 404.
}