Rating System: Difference between revisions
From MusicBrainz Wiki
Jump to navigationJump to search
Reosarevok (talk | contribs) mNo edit summary |
(update description, remove API section: documented at MusicBrainz_API#ratings / History:Development/XML_Web_Service/Version_1#ratings_resources) |
||
(One intermediate revision by the same user not shown) | |||
Line 1: | Line 1: | ||
==Description== |
==Description== |
||
The rating system allows users to rate MusicBrainz entities (artists, labels, |
The rating system allows users to rate MusicBrainz entities (artists, labels, release groups, recordings, events, works). |
||
==Details== |
==Details== |
||
Line 8: | Line 8: | ||
The community rating is shown by default for each entity, however, once a user submits their own rating that value will be shown instead. |
The community rating is shown by default for each entity, however, once a user submits their own rating that value will be shown instead. |
||
''Display of ratings can be disabled in User Preferences for those who prefer not to use or see ratings''. |
|||
==Color Definitions== |
==Color Definitions== |
||
Line 23: | Line 21: | ||
| [[Image:star_big_community-rated.gif]] || [[Image:star_small_community-rated.gif]] || Community rating |
| [[Image:star_big_community-rated.gif]] || [[Image:star_small_community-rated.gif]] || Community rating |
||
|} |
|} |
||
==Web Service== |
|||
The [[XML Web Service]] has been updated in order to allow to retrieve or update ratings via WS in a similar way to how [[Folksonomy Tagging|folksonomy tagging]] works. |
|||
The two methods of submission/retrieval are: |
|||
# Using the new /rating resource for submitting/retrieving one specific rating. |
|||
#: <code>wget --user=<editor name> --password=<password> --post-data=id=8f6bd1e4-fbe1-4f50-aa9b-94c450ec0f11\&entity=artist\&rating=3 http://test.musicbrainz.org/ws/1/rating</code> |
|||
# Using the two new inc parameters with the artist, label, release or tracks resources as described in [[XML Web Service]]. |
|||
#: <code>ratings</code> and <code>user-ratings</code> |
|||
[[Category:Documentation]] [[Category:To Be Reviewed]] |
[[Category:Documentation]] [[Category:To Be Reviewed]] |
Latest revision as of 22:57, 21 January 2021
Description
The rating system allows users to rate MusicBrainz entities (artists, labels, release groups, recordings, events, works).
Details
User may assign a value between 1 and 5 to various entities as a rating, these values are then aggregated by the server to compute an average community rating for that same entity.
The community rating is shown by default for each entity, however, once a user submits their own rating that value will be shown instead.
Color Definitions
Unrated | ||
Hover | ||
User rating | ||
Community rating |