Reseñas
Las reseñas del dueño.
Los textos son Markdown, y pasan por el mismo renderizador que usa el sitio.
/api/Índice de registros propios por juego y total de recorridos.
/api/Una reseña visible, autor y contexto de interacción. Acepta UUID o id público sin exigir sesión.
/api/Reseñas visibles, 20 por página. q busca texto y recorrido; sort: recent, oldest o rating; page: 1 a 100.
/api/Las reseñas del dueño, las más recientes primero.
Parámetros
| Campo | Tipo | Notas |
|---|---|---|
page | integer | De 1 a 1000. |
game | integer | Filtra por id de juego. |
limit | integer | 1 a 1000, predeterminado 50. |
/api/Escribe una reseña. Responde 201.
Cuerpo
| Campo | Tipo | Notas |
|---|---|---|
igdb_idobligatorio | integer | El id del juego en el catálogo. |
game_slugobligatorio | string | El slug del juego. |
content | string | Markdown, hasta 5000 caracteres. |
title | string | Hasta 80 caracteres. |
rating | integer | De 0 a 100. |
rating_mode | string | stars_5, level_5, score_10, score_100 o recommend. |
visibility | string | PUBLIC, FOLLOWERS o PRIVATE. |
contains_spoilers | boolean | Por defecto: false. |
platform | string | Dónde se jugó. |
started_on | date | AAAA-MM-DD. |
finished_on | date | AAAA-MM-DD. |
journey_id | string | El recorrido que esta reseña cierra. Debe ser un recorrido tuyo y del mismo juego. |
aspects | array | Las partes puntuadas, hasta 12, cada una con label, rating y un note opcional. Se escriben en la misma transacción que la reseña, así que nunca existe una reseña con la mitad de ellas. |
/api/Cambia una reseña. Acepta los mismos campos que el POST, sin igdb_id ni game_slug. Lo que no se envía mantiene su valor, con una excepción: aspects se reescribe entero, porque las partes solo significan algo como conjunto. comments_scope acepta EVERYONE, FOLLOWERS o NOBODY y decide quién puede responder.
/api/Elimina una reseña.