Reviews
The owner's reviews.
Bodies are Markdown, and are rendered by the same pipeline the website uses.
/api/Own entries grouped by game and journey count.
/api/A visible review, its author and interaction context. Accepts UUID or public id without requiring a session.
/api/Visible reviews, 20 per page. q searches text and journey; sort: recent, oldest or rating; page: 1 to 100.
/api/The owner's reviews, newest first.
Query
| Field | Type | Notes |
|---|---|---|
page | integer | 1 to 1000. |
game | integer | Filter by game id. |
limit | integer | 1 to 1000, default 50. |
/api/Write a review. Answers 201.
Body
| Field | Type | Notes |
|---|---|---|
igdb_idrequired | integer | The game's catalog id. |
game_slugrequired | string | The game's slug. |
content | string | Markdown, up to 5000 characters. |
title | string | Up to 80 characters. |
rating | integer | 0 to 100. |
rating_mode | string | stars_5, level_5, score_10, score_100 or recommend. |
visibility | string | PUBLIC, FOLLOWERS or PRIVATE. |
contains_spoilers | boolean | Defaults to false. |
platform | string | Where it was played. |
started_on | date | YYYY-MM-DD. |
finished_on | date | YYYY-MM-DD. |
journey_id | string | The journey this review closes. It has to be your own journey, on the same game. |
aspects | array | The scored parts, up to 12, each with a label, a rating and an optional note. They are written in the same transaction as the review, so a review never exists with half of them attached. |
/api/Change a review. It takes the same fields as the POST, without igdb_id or game_slug. Anything left out keeps its value, with one exception: aspects is rewritten whole, because the parts only mean anything as a set. comments_scope takes EVERYONE, FOLLOWERS or NOBODY and decides who may reply.
/api/Remove a review.