uloggd

Un recorrido es un paso por un juego. Una sesión puede marcar el comienzo o el final de uno.

GET/api/v1/journal/entries

Sesiones registradas, las jugadas más recientes primero.

Permiso journal.read · Cuenta en la cuota read

Parámetros

Campo	Tipo	Notas
`game`	integer	Filtra por id de juego.
`limit`	integer	1 a 1000, predeterminado 50.

POST/api/v1/journal/entries

Registra una sesión. Responde 201.

Permiso journal.write · Cuenta en la cuota write

Cuerpo

Campo	Tipo	Notas
`igdb_id`obligatorio	integer	El id del juego en el catálogo.
`game_slug`obligatorio	string	El slug del juego.
`played_on`	date	AAAA-MM-DD. Por defecto: hoy.
`ended_on`	date	Para una sesión que cruza días.
`minutes`	integer	De 0 a 100000.
`note`	string	Markdown, hasta 5000 caracteres.
`visibility`	string	PUBLIC, FOLLOWERS o PRIVATE.
`marks_start`	boolean	Esta sesión empezó el juego.
`marks_finish`	boolean	Esta sesión lo terminó.
`started_at`	string	La hora en que empezó la sesión, HH:MM o HH:MM:SS. Opcional: un día entero también es una sesión.
`journey_id`	string	El recorrido al que pertenece esta sesión. Debe ser un recorrido tuyo y del mismo juego; sin él la sesión queda suelta.
`comments_scope`	string	Quién puede responder: EVERYONE, FOLLOWERS o NOBODY.

PATCH/api/v1/journal/entries/{id}

Cambia una sesión. Acepta los mismos campos que el POST, sin igdb_id ni game_slug, y dos más que solo tienen sentido una vez que la sesión existe.

Permiso journal.write · Cuenta en la cuota write

Cuerpo

Campo	Tipo	Notas
`sensitive`	boolean	Esconde las imágenes tras un aviso. Apagarlo no borra el registro de una marca automática: es lo que deja la decisión revisable después.
`image_order`	array	Los ids de las imágenes de la sesión, en el orden en que deben aparecer, hasta 12. Las imágenes entran por el sitio; aquí solo se ordena lo que ya está.

DELETE/api/v1/journal/entries/{id}

Elimina una sesión.

Permiso journal.write · Cuenta en la cuota write

PUT/api/v1/journal/days

Marca varios días de una vez como jugados, sin describir ninguno. Es el trazo en el calendario: un día ya cubierto por una sesión se deja como está, y added cuenta lo que cambió, no lo que se pidió.

Permiso journal.write · Cuenta en la cuota write

Cuerpo

Campo	Tipo	Notas
`igdb_id`obligatorio	integer	El id del juego en el catálogo.
`game_slug`obligatorio	string	El slug del juego.
`days`obligatorio	array	De 1 a 366 fechas como YYYY-MM-DD. Ninguna puede estar en el futuro.
`journey_id`	string	El recorrido al que pertenecen los días. Sin él, quedan sueltos.

Ejemplo

{
  "data": { "igdb_id": 14593, "days": ["2026-09-01", "2026-09-02"], "added": 1 }
}

DELETE/api/v1/journal/days

Elimina las sesiones que cubren esos días. Va por parámetro y no por cuerpo, porque un DELETE con cuerpo no atraviesa a todo intermediario.

Permiso journal.write · Cuenta en la cuota write

Parámetros

Campo	Tipo	Notas
`igdb_id`obligatorio	integer	El id del juego en el catálogo.
`days`obligatorio	string	Las fechas separadas por comas, de 1 a 366.
`journey_id`	string	Limita la eliminación a las sesiones de ese recorrido.

GET/api/v1/journal/entries/{id}

Una entrada visible, autor, galería y contexto de interacción.

Permiso journal.read · Cuenta en la cuota read

GET/api/v1/journal/journeys/{id}

Metadatos públicos de un recorrido y cantidad de sesiones públicas.

Permiso journal.read · Cuenta en la cuota read

GET/api/v1/journal/journeys/{id}/entries

Sesiones visibles de un recorrido, 40 por página, con imágenes y resumen. page: 1 a 1000.

Permiso journal.read · Cuenta en la cuota read

GET/api/v1/journal/journeys

Los recorridos del dueño.

Permiso journal.read · Cuenta en la cuota read

Parámetros

Campo	Tipo	Notas
`game`	integer	Filtra por id de juego.
`limit`	integer	1 a 1000, predeterminado 50.

POST/api/v1/journal/journeys

Abre un recorrido en un juego. Responde 201.

Permiso journal.write · Cuenta en la cuota write

Cuerpo

Campo	Tipo	Notas
`igdb_id`obligatorio	integer	El id del juego en el catálogo.
`game_slug`obligatorio	string	El slug del juego.
`title`obligatorio	string	Hasta 120 caracteres.

PATCH/api/v1/journal/journeys/{id}

Renombra un recorrido, o dice qué tipo de recorrido fue. Un campo por vez: lo que el cuerpo omite queda como está, y lo que clear nombra queda vacío. Terminar antes de empezar se rechaza.

Permiso journal.write · Cuenta en la cuota write

Cuerpo

Campo	Tipo	Notas
`title`	string	Hasta 120 caracteres.
`status`	string	PLANNED, PLAYING, ON_HOLD, COMPLETED o DROPPED. Es el estado del recorrido, no el del juego.
`started_on`	string	AAAA-MM-DD.
`finished_on`	string	AAAA-MM-DD.
`library_entry_id`	string	La copia en que se jugó este recorrido.
`replay`	boolean	Si el juego ya se había jugado antes de este.
`mastered`	boolean	Si la platina o el 100% salieron de este recorrido.
`difficulty`	string	Hasta 80 caracteres.
`progress`	string	Hasta 160 caracteres.
`clear`	array	Campos a vaciar: status, started_on, finished_on, difficulty, progress, replay, mastered o library_entry_id. Un campo no puede llevar un valor y estar en clear a la vez.

DELETE/api/v1/journal/journeys/{id}

Elimina un recorrido.

Permiso journal.write · Cuenta en la cuota write

GET/api/v1/journal/sessions

La sesión abierta del dueño, con su juego y sus eventos. Responde data: null cuando no hay ninguna.

Permiso journal.read · Cuenta en la cuota read

POST/api/v1/journal/sessions

Abre una sesión. Una por cuenta: responde 409 cuando ya hay otra abierta. Responde 201.

Permiso journal.write · Cuenta en la cuota write

Cuerpo

Campo	Tipo	Notas
`igdb_id`obligatorio	integer	El id del juego en el catálogo.
`game_slug`obligatorio	string	El slug del juego.
`journey_id`	string	Vincula la sesión a un recorrido tuyo.
`visibility`	string	PUBLIC, FOLLOWERS o PRIVATE.

POST/api/v1/journal/sessions/{id}/events

Anota algo que pasó en la sesión abierta. Solo agrega: un evento no se edita. Responde 201.

Permiso journal.write · Cuenta en la cuota write

Cuerpo

Campo	Tipo	Notas
`kind`obligatorio	string	NOTE, PROGRESS, SHOT o STOP. NOTE y STOP piden body, PROGRESS pide marker, SHOT pide screenshot_id.
`body`	string	Hasta 500 caracteres.
`marker`	string	Hasta 80 caracteres.
`screenshot_id`	string	Una captura tuya.

PATCH/api/v1/journal/sessions/{id}

Cierra la sesión, que es lo que la convierte en registro. Sin minutos, vale el tiempo corrido, limitado a 16 horas.

Permiso journal.write · Cuenta en la cuota write

Cuerpo

Campo	Tipo	Notas
`minutes`	integer	De 0 a 100000. El reloj cuenta, tú confirmas.
`note`	string	Hasta 5000 caracteres.
`marks_finish`	boolean	Marca que el juego terminó en esta sesión.

DELETE/api/v1/journal/sessions/{id}

Descarta una sesión abierta que no registró nada. Responde 409 cuando ya tiene eventos: entonces el camino es cerrar.

Permiso journal.write · Cuenta en la cuota write

Un recorrido es un paso por un juego. Una sesión puede marcar el comienzo o el final de uno.

GET/api/v1/journal/entries

Sesiones registradas, las jugadas más recientes primero.

Permiso journal.read · Cuenta en la cuota read

Parámetros

Campo	Tipo	Notas
`game`	integer	Filtra por id de juego.
`limit`	integer	1 a 1000, predeterminado 50.

POST/api/v1/journal/entries

Registra una sesión. Responde 201.

Permiso journal.write · Cuenta en la cuota write

Cuerpo

Campo	Tipo	Notas
`igdb_id`obligatorio	integer	El id del juego en el catálogo.
`game_slug`obligatorio	string	El slug del juego.
`played_on`	date	AAAA-MM-DD. Por defecto: hoy.
`ended_on`	date	Para una sesión que cruza días.
`minutes`	integer	De 0 a 100000.
`note`	string	Markdown, hasta 5000 caracteres.
`visibility`	string	PUBLIC, FOLLOWERS o PRIVATE.
`marks_start`	boolean	Esta sesión empezó el juego.
`marks_finish`	boolean	Esta sesión lo terminó.
`started_at`	string	La hora en que empezó la sesión, HH:MM o HH:MM:SS. Opcional: un día entero también es una sesión.
`journey_id`	string	El recorrido al que pertenece esta sesión. Debe ser un recorrido tuyo y del mismo juego; sin él la sesión queda suelta.
`comments_scope`	string	Quién puede responder: EVERYONE, FOLLOWERS o NOBODY.

PATCH/api/v1/journal/entries/{id}

Cambia una sesión. Acepta los mismos campos que el POST, sin igdb_id ni game_slug, y dos más que solo tienen sentido una vez que la sesión existe.

Permiso journal.write · Cuenta en la cuota write

Cuerpo

Campo	Tipo	Notas
`sensitive`	boolean	Esconde las imágenes tras un aviso. Apagarlo no borra el registro de una marca automática: es lo que deja la decisión revisable después.
`image_order`	array	Los ids de las imágenes de la sesión, en el orden en que deben aparecer, hasta 12. Las imágenes entran por el sitio; aquí solo se ordena lo que ya está.

DELETE/api/v1/journal/entries/{id}

Elimina una sesión.

Permiso journal.write · Cuenta en la cuota write

PUT/api/v1/journal/days

Permiso journal.write · Cuenta en la cuota write

Cuerpo

Campo	Tipo	Notas
`igdb_id`obligatorio	integer	El id del juego en el catálogo.
`game_slug`obligatorio	string	El slug del juego.
`days`obligatorio	array	De 1 a 366 fechas como YYYY-MM-DD. Ninguna puede estar en el futuro.
`journey_id`	string	El recorrido al que pertenecen los días. Sin él, quedan sueltos.

Ejemplo

{
  "data": { "igdb_id": 14593, "days": ["2026-09-01", "2026-09-02"], "added": 1 }
}

DELETE/api/v1/journal/days

Elimina las sesiones que cubren esos días. Va por parámetro y no por cuerpo, porque un DELETE con cuerpo no atraviesa a todo intermediario.

Permiso journal.write · Cuenta en la cuota write

Parámetros

Campo	Tipo	Notas
`igdb_id`obligatorio	integer	El id del juego en el catálogo.
`days`obligatorio	string	Las fechas separadas por comas, de 1 a 366.
`journey_id`	string	Limita la eliminación a las sesiones de ese recorrido.

GET/api/v1/journal/entries/{id}

Una entrada visible, autor, galería y contexto de interacción.

Permiso journal.read · Cuenta en la cuota read

GET/api/v1/journal/journeys/{id}

Metadatos públicos de un recorrido y cantidad de sesiones públicas.

Permiso journal.read · Cuenta en la cuota read

GET/api/v1/journal/journeys/{id}/entries

Sesiones visibles de un recorrido, 40 por página, con imágenes y resumen. page: 1 a 1000.

Permiso journal.read · Cuenta en la cuota read

GET/api/v1/journal/journeys

Los recorridos del dueño.

Permiso journal.read · Cuenta en la cuota read

Parámetros

Campo	Tipo	Notas
`game`	integer	Filtra por id de juego.
`limit`	integer	1 a 1000, predeterminado 50.

POST/api/v1/journal/journeys

Abre un recorrido en un juego. Responde 201.

Permiso journal.write · Cuenta en la cuota write

Cuerpo

Campo	Tipo	Notas
`igdb_id`obligatorio	integer	El id del juego en el catálogo.
`game_slug`obligatorio	string	El slug del juego.
`title`obligatorio	string	Hasta 120 caracteres.

PATCH/api/v1/journal/journeys/{id}

Renombra un recorrido, o dice qué tipo de recorrido fue. Un campo por vez: lo que el cuerpo omite queda como está, y lo que clear nombra queda vacío. Terminar antes de empezar se rechaza.

Permiso journal.write · Cuenta en la cuota write

Cuerpo

Campo	Tipo	Notas
`title`	string	Hasta 120 caracteres.
`status`	string	PLANNED, PLAYING, ON_HOLD, COMPLETED o DROPPED. Es el estado del recorrido, no el del juego.
`started_on`	string	AAAA-MM-DD.
`finished_on`	string	AAAA-MM-DD.
`library_entry_id`	string	La copia en que se jugó este recorrido.
`replay`	boolean	Si el juego ya se había jugado antes de este.
`mastered`	boolean	Si la platina o el 100% salieron de este recorrido.
`difficulty`	string	Hasta 80 caracteres.
`progress`	string	Hasta 160 caracteres.
`clear`	array	Campos a vaciar: status, started_on, finished_on, difficulty, progress, replay, mastered o library_entry_id. Un campo no puede llevar un valor y estar en clear a la vez.

DELETE/api/v1/journal/journeys/{id}

Elimina un recorrido.

Permiso journal.write · Cuenta en la cuota write

GET/api/v1/journal/sessions

La sesión abierta del dueño, con su juego y sus eventos. Responde data: null cuando no hay ninguna.

Permiso journal.read · Cuenta en la cuota read

POST/api/v1/journal/sessions

Abre una sesión. Una por cuenta: responde 409 cuando ya hay otra abierta. Responde 201.

Permiso journal.write · Cuenta en la cuota write

Cuerpo

Campo	Tipo	Notas
`igdb_id`obligatorio	integer	El id del juego en el catálogo.
`game_slug`obligatorio	string	El slug del juego.
`journey_id`	string	Vincula la sesión a un recorrido tuyo.
`visibility`	string	PUBLIC, FOLLOWERS o PRIVATE.

POST/api/v1/journal/sessions/{id}/events

Anota algo que pasó en la sesión abierta. Solo agrega: un evento no se edita. Responde 201.

Permiso journal.write · Cuenta en la cuota write

Cuerpo

Campo	Tipo	Notas
`kind`obligatorio	string	NOTE, PROGRESS, SHOT o STOP. NOTE y STOP piden body, PROGRESS pide marker, SHOT pide screenshot_id.
`body`	string	Hasta 500 caracteres.
`marker`	string	Hasta 80 caracteres.
`screenshot_id`	string	Una captura tuya.

PATCH/api/v1/journal/sessions/{id}

Cierra la sesión, que es lo que la convierte en registro. Sin minutos, vale el tiempo corrido, limitado a 16 horas.

Permiso journal.write · Cuenta en la cuota write

Cuerpo

Campo	Tipo	Notas
`minutes`	integer	De 0 a 100000. El reloj cuenta, tú confirmas.
`note`	string	Hasta 5000 caracteres.
`marks_finish`	boolean	Marca que el juego terminó en esta sesión.

DELETE/api/v1/journal/sessions/{id}

Descarta una sesión abierta que no registró nada. Responde 409 cuando ya tiene eventos: entonces el camino es cerrar.

Permiso journal.write · Cuenta en la cuota write

Diario

Parámetros

Cuerpo

Cuerpo

Cuerpo

Ejemplo

Parámetros

Parámetros

Cuerpo

Cuerpo

Cuerpo

Cuerpo

Cuerpo

Diario

Parámetros

Cuerpo

Cuerpo

Cuerpo

Ejemplo

Parámetros

Parámetros

Cuerpo

Cuerpo

Cuerpo

Cuerpo

Cuerpo