uloggd

Una lista es alcanzable por su id o su id público. La respuesta trae owned, para que el cliente sepa si puede escribir antes de intentarlo.

GET/api/v1/lists/{id}/tiers

Tierlist visible con portadas. pool=1 incluye juegos disponibles para su dueño.

Permiso lists.read · Cuenta en la cuota read

GET/api/v1/lists/{id}/collaborators

Quién edita los juegos de la lista con su dueño, tan visible como la propia lista.

Permiso lists.read · Cuenta en la cuota read

POST/api/v1/lists/{id}/collaborators

Invita a alguien a editar los juegos. Cuerpo: username. Solo el dueño; hasta 20 personas; las cuentas bloqueadas no se encuentran. Los colaboradores añaden, quitan, reordenan y marcan juegos; nombre, visibilidad y eliminación siguen siendo del dueño.

Permiso lists.write · Cuenta en la cuota write

DELETE/api/v1/lists/{id}/collaborators

Quita un colaborador: profile_id en la query. El dueño quita a cualquiera; un colaborador se quita a sí mismo para salir.

Permiso lists.write · Cuenta en la cuota write

GET/api/v1/search/lists

Listas públicas, 24 por página. q, kind: COLLECTION o TIERLIST, sort: recent, oldest o name; page: 1 a 100.

Permiso lists.read · Cuenta en la cuota read

GET/api/v1/lists

Las listas del dueño.

Permiso lists.read · Cuenta en la cuota read

GET/api/v1/lists/folders

Las carpetas del dueño, con cuántas listas hay en cada una. unfiled cuenta las listas sin carpeta. Una carpeta es solo un título sobre listas: no tiene visibilidad propia, así que archivar una lista privada no la publica y archivar una pública no la esconde.

Permiso lists.read · Cuenta en la cuota read

POST/api/v1/lists/folders

Crea una carpeta. Pedir un nombre que ya existe devuelve esa carpeta, y `created` dice qué pasó.

Permiso lists.write · Cuenta en la cuota write

Cuerpo

Campo	Tipo	Notas
`name`obligatorio	string	Hasta 60 caracteres.
`position`	integer	El orden del dueño, de 0 a 999. Alfabético no es lo que nadie quiere decir con sus propios estantes.

PATCH/api/v1/lists/folders/{id}

Renombra una carpeta o la mueve en el orden. La carpeta de otra persona no se rechaza: sencillamente no existe para quien pregunta.

Permiso lists.write · Cuenta en la cuota write

Cuerpo

Campo	Tipo	Notas
`name`	string	Hasta 60 caracteres.
`position`	integer	0 a 999.

DELETE/api/v1/lists/folders/{id}

Olvida una carpeta. Las listas que había quedan sin carpeta y siguen existiendo: ordenar un estante no es tirar lo que había en él.

Permiso lists.write · Cuenta en la cuota write

POST/api/v1/lists

Crea una lista. Responde 201.

Permiso lists.write · Cuenta en la cuota write

Cuerpo

Campo	Tipo	Notas
`name`obligatorio	string	Hasta 100 caracteres.
`description`	string	Hasta 500 caracteres.
`kind`	string	COLLECTION o TIERLIST. Una TIERLIST nace con cinco filas: una creada sin ellas no tendría dónde poner nada.
`visibility`	string	PUBLIC, FOLLOWERS o PRIVATE.
`ranked`	boolean	Un ranking en lugar de una colección.

GET/api/v1/lists/{id}

Una lista con sus elementos. Acepta el id o el id público, y trae `owned` para que el cliente sepa si puede escribir.

Permiso lists.read · Cuenta en la cuota read

PATCH/api/v1/lists/{id}

Renombra una lista o cambia su descripción, visibilidad, orden o comments_scope, que acepta EVERYONE, FOLLOWERS o NOBODY. folder_ids archiva la lista en las carpetas tuyas que nombre, reemplazando las anteriores: una lista puede estar en varias, y una lista vacía la saca de todas. Archivar no cambia quién ve qué.

Permiso lists.write · Cuenta en la cuota write

Cuerpo

Campo	Tipo	Notas
`name`	string	Hasta 120 caracteres.
`description`	string	Hasta 1000 caracteres.
`visibility`	string	PUBLIC, FOLLOWERS o PRIVATE.
`ranked`	boolean	Si el orden de la lista es su razón de ser.
`folder_ids`	array	Los ids de tus carpetas, hasta 40. Reemplaza el conjunto anterior, así que [] la saca de todas. La carpeta de otra persona la rechaza la base de datos, y no una comprobación escrita dos veces.

DELETE/api/v1/lists/{id}

Elimina una lista.

Permiso lists.write · Cuenta en la cuota write

PUT/api/v1/lists/{id}/tiers

Guarda las filas de una tierlist y dónde está cada juego, de una vez. No es un PATCH por elemento: una tierlist solo tiene sentido entera, y guardar una fila y su contenido por separado dejaría un instante en que un juego está en una fila que nadie definió.

Permiso lists.write · Cuenta en la cuota write

Cuerpo

Campo	Tipo	Notas
`tiers`obligatorio	array	Las filas, cada una con id, label, color y position. El id es tuyo y no de la base: las filas se reescriben enteras en cada guardado, y son los elementos los que necesitan nombrarlas. Hasta 26.
`items`obligatorio	array	Cada juego, con tier_id, igdb_id, game_slug y position. Un juego que salió de la biblioteca del dueño, o cuyo tier_id no está entre las filas enviadas, se omite en silencio en vez de tumbar el guardado. Hasta 1000.

POST/api/v1/lists/{id}/items

Agrega un juego a una lista. Responde 201.

Permiso lists.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.

PATCH/api/v1/lists/{id}/items/{item_id}

Anota un elemento, cambia cómo se ve en la lista, o lo mueve. Posición y dirección son dos formas de decir lo mismo, así que envía una u otra.

Permiso lists.write · Cuenta en la cuota write

Cuerpo

Campo	Tipo	Notas
`note`	string	Hasta 500 caracteres.
`mark_mode`	string	COLOR o DIM, o null para quitar el destacado. Es solo apariencia: lo que significa lo dice el autor, en la descripción de la lista. El sistema nunca asocia un color a un estado.
`mark_color`	string	Con mark_mode COLOR: RED, ORANGE, YELLOW, GREEN, CYAN, BLUE, PURPLE, PINK o NEUTRAL.
`marked`	boolean	Obsoleto. Significaba «completado», que es un significado entre muchos. true se vuelve mark_mode DIM y false quita el destacado.
`position`	integer	La posición exacta, contando desde 0.
`direction`	string	up, down o top, para mover sin saber la posición.

DELETE/api/v1/lists/{id}/items/{item_id}

Saca un juego de la lista.

Permiso lists.write · Cuenta en la cuota write

Una lista es alcanzable por su id o su id público. La respuesta trae owned, para que el cliente sepa si puede escribir antes de intentarlo.

GET/api/v1/lists/{id}/tiers

Tierlist visible con portadas. pool=1 incluye juegos disponibles para su dueño.

Permiso lists.read · Cuenta en la cuota read

GET/api/v1/lists/{id}/collaborators

Quién edita los juegos de la lista con su dueño, tan visible como la propia lista.

Permiso lists.read · Cuenta en la cuota read

POST/api/v1/lists/{id}/collaborators

Permiso lists.write · Cuenta en la cuota write

DELETE/api/v1/lists/{id}/collaborators

Quita un colaborador: profile_id en la query. El dueño quita a cualquiera; un colaborador se quita a sí mismo para salir.

Permiso lists.write · Cuenta en la cuota write

GET/api/v1/search/lists

Listas públicas, 24 por página. q, kind: COLLECTION o TIERLIST, sort: recent, oldest o name; page: 1 a 100.

Permiso lists.read · Cuenta en la cuota read

GET/api/v1/lists

Las listas del dueño.

Permiso lists.read · Cuenta en la cuota read

GET/api/v1/lists/folders

Permiso lists.read · Cuenta en la cuota read

POST/api/v1/lists/folders

Crea una carpeta. Pedir un nombre que ya existe devuelve esa carpeta, y `created` dice qué pasó.

Permiso lists.write · Cuenta en la cuota write

Cuerpo

Campo	Tipo	Notas
`name`obligatorio	string	Hasta 60 caracteres.
`position`	integer	El orden del dueño, de 0 a 999. Alfabético no es lo que nadie quiere decir con sus propios estantes.

PATCH/api/v1/lists/folders/{id}

Renombra una carpeta o la mueve en el orden. La carpeta de otra persona no se rechaza: sencillamente no existe para quien pregunta.

Permiso lists.write · Cuenta en la cuota write

Cuerpo

Campo	Tipo	Notas
`name`	string	Hasta 60 caracteres.
`position`	integer	0 a 999.

DELETE/api/v1/lists/folders/{id}

Olvida una carpeta. Las listas que había quedan sin carpeta y siguen existiendo: ordenar un estante no es tirar lo que había en él.

Permiso lists.write · Cuenta en la cuota write

POST/api/v1/lists

Crea una lista. Responde 201.

Permiso lists.write · Cuenta en la cuota write

Cuerpo

Campo	Tipo	Notas
`name`obligatorio	string	Hasta 100 caracteres.
`description`	string	Hasta 500 caracteres.
`kind`	string	COLLECTION o TIERLIST. Una TIERLIST nace con cinco filas: una creada sin ellas no tendría dónde poner nada.
`visibility`	string	PUBLIC, FOLLOWERS o PRIVATE.
`ranked`	boolean	Un ranking en lugar de una colección.

GET/api/v1/lists/{id}

Una lista con sus elementos. Acepta el id o el id público, y trae `owned` para que el cliente sepa si puede escribir.

Permiso lists.read · Cuenta en la cuota read

PATCH/api/v1/lists/{id}

Permiso lists.write · Cuenta en la cuota write

Cuerpo

Campo	Tipo	Notas
`name`	string	Hasta 120 caracteres.
`description`	string	Hasta 1000 caracteres.
`visibility`	string	PUBLIC, FOLLOWERS o PRIVATE.
`ranked`	boolean	Si el orden de la lista es su razón de ser.
`folder_ids`	array	Los ids de tus carpetas, hasta 40. Reemplaza el conjunto anterior, así que [] la saca de todas. La carpeta de otra persona la rechaza la base de datos, y no una comprobación escrita dos veces.

DELETE/api/v1/lists/{id}

Elimina una lista.

Permiso lists.write · Cuenta en la cuota write

PUT/api/v1/lists/{id}/tiers

Permiso lists.write · Cuenta en la cuota write

Cuerpo

Campo	Tipo	Notas
`tiers`obligatorio	array	Las filas, cada una con id, label, color y position. El id es tuyo y no de la base: las filas se reescriben enteras en cada guardado, y son los elementos los que necesitan nombrarlas. Hasta 26.
`items`obligatorio	array	Cada juego, con tier_id, igdb_id, game_slug y position. Un juego que salió de la biblioteca del dueño, o cuyo tier_id no está entre las filas enviadas, se omite en silencio en vez de tumbar el guardado. Hasta 1000.

POST/api/v1/lists/{id}/items

Agrega un juego a una lista. Responde 201.

Permiso lists.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.

PATCH/api/v1/lists/{id}/items/{item_id}

Anota un elemento, cambia cómo se ve en la lista, o lo mueve. Posición y dirección son dos formas de decir lo mismo, así que envía una u otra.

Permiso lists.write · Cuenta en la cuota write

Cuerpo

Campo	Tipo	Notas
`note`	string	Hasta 500 caracteres.
`mark_mode`	string	COLOR o DIM, o null para quitar el destacado. Es solo apariencia: lo que significa lo dice el autor, en la descripción de la lista. El sistema nunca asocia un color a un estado.
`mark_color`	string	Con mark_mode COLOR: RED, ORANGE, YELLOW, GREEN, CYAN, BLUE, PURPLE, PINK o NEUTRAL.
`marked`	boolean	Obsoleto. Significaba «completado», que es un significado entre muchos. true se vuelve mark_mode DIM y false quita el destacado.
`position`	integer	La posición exacta, contando desde 0.
`direction`	string	up, down o top, para mover sin saber la posición.

DELETE/api/v1/lists/{id}/items/{item_id}

Saca un juego de la lista.

Permiso lists.write · Cuenta en la cuota write