Tanks

Rate a tank

Cast or revise this account's opinion of a vehicle. Requires a signed-in Wargaming account that has actually played the tank: the endpoint reads the caller's own record on it and refuses with 403 below the battle threshold, which is what makes this average worth more than a poll of whoever showed up. One opinion per account per tank, so sending again replaces the previous one rather than adding to it. The evidence the vote rests on (battles, win rate, damage, the account's rating) is copied onto it at the moment it is cast, and the client version is stamped, so an opinion stays attached to the tank it was formed on. A written opinion is queued for moderation and never published here; the stars count immediately. The vote is recorded under the caller's own region, whatever region the page was opened on. 401 when signed out, 403 when the record is too thin, 404 for an unknown tank.

post/{region}/tanks/{slug}/rate

Request

  • Base URL: https://unicum.gg/api
  • URL: https://unicum.gg/api/{region}/tanks/{slug}/rate
  • Auth: none required

Path parameters

region'eu' | 'na' | 'asia' required

Game server region.

slugstring required

Tank slug (e.g. is-7).

Request body

overallinteger required
funinteger required
firepowerinteger
armourinteger
mobilityinteger
gunHandlinginteger
concealmentinteger
beginnerFriendlinessinteger
versatilityinteger
reviewstring nullable

A written opinion, queued for moderation rather than published. Send null to withdraw one previously written; leaving the field out entirely keeps whatever is already there. Measured after whitespace is collapsed.

anonymousboolean

Publish the written opinion without the author's name. The record it rests on (battles, win rate, damage, the account's rating) is published either way, since that is what makes a review worth reading. Leaving the field out keeps whatever was chosen before, so a caller sending only new stars cannot put a name back on a review published without one.

Response

Successful response

okboolean required
discordLinkedboolean required

Whether the caller has a Discord account linked, which is what lets a moderator's verdict reach them as a direct message. False is not an error: the review is queued either way and the site shows its status.

review'none' | 'queued' | 'published' | 'pending' | 'rejected' | 'closed' required

What became of a written opinion attached to a rating.

Changes

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