Ratings
Ratings

Submit Rating

Submit app rating and receive bonus scans if eligible

Requirements:

  • User must not have rated before
  • Rating must be 1-5 stars
  • Comment is optional

Bonus scans:

  • Free plan users who've used all scans: Receive 5 bonus scans
  • Premium users: Can rate for feedback, no bonus
  • Free users with scans remaining: Can rate, no bonus until scans used

Returns:

  • success: true
  • rating_id: ID of created rating
  • bonus_scans_granted: Number of bonus scans (0 or 5)
  • new_scans_available: Updated scan count
post/api/v1/ratings/submit

Request

  • Base URL: https://api.gemstoneaiapp.com (the document declares no server; this is the origin it was published from)
  • URL: https://api.gemstoneaiapp.com/api/v1/ratings/submit
  • Auth: HTTP bearer

Request body

rating_valueinteger required

Star rating (1-5)

commentstring nullable

Optional comment

Example request

{
  "comment": "Great app for identifying gemstones!",
  "rating_value": 5
}

Response

Successful Response

successboolean required
messagestring required
rating_idinteger required
rating_valueinteger required
bonus_scans_grantedinteger required
new_scans_availableinteger required
created_atstring date-time required

Changes

No recorded changes to this operation across all 1 revision of this API.