uloggd

Uma lista é alcançável pelo id ou pelo id público. A resposta traz owned, para o cliente saber se pode escrever antes de tentar.

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

Tierlist visível com capas. pool=1 inclui jogos disponíveis para o dono.

Escopo lists.read · Conta na cota read

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

Quem edita os jogos da lista com o dono, tão visível quanto a própria lista.

Escopo lists.read · Conta na cota read

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

Convida alguém para editar os jogos. Corpo: username. Só o dono; até 20 pessoas; contas bloqueadas não são encontradas. Colaboradores adicionam, removem, reordenam e marcam jogos; nome, visibilidade e exclusão continuam do dono.

Escopo lists.write · Conta na cota write

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

Remove um colaborador: profile_id na query. O dono remove qualquer um; um colaborador remove a si mesmo para sair.

Escopo lists.write · Conta na cota write

GET/api/v1/search/lists

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

Escopo lists.read · Conta na cota read

GET/api/v1/lists

As listas do dono.

Escopo lists.read · Conta na cota read

GET/api/v1/lists/folders

As pastas do dono, com quantas listas há em cada uma, na ordem que ele deu. unfiled conta as listas que não estão em nenhuma pasta. Uma lista pode estar em várias. Cada uma traz id e public_id: o primeiro é o que uma lista aponta, o segundo é o que vai no endereço. Uma pasta é só um título sobre listas: não tem visibilidade própria, então arquivar uma lista privada não a publica e arquivar uma pública não a esconde.

Escopo lists.read · Conta na cota read

POST/api/v1/lists/folders

Cria uma pasta. Pedir um nome que já existe devolve a pasta que já existe, e `created` diz o que aconteceu.

Escopo lists.write · Conta na cota write

Corpo

Campo	Tipo	Observações
`name`obrigatório	string	Até 60 caracteres.
`position`	integer	A ordem do dono, de 0 a 999. Alfabética não é o que ninguém quer dizer com as próprias estantes.

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

Renomeia uma pasta ou a move na ordem. Aceita o id ou o public_id. A pasta de outra pessoa não é recusada: ela simplesmente não existe para quem pergunta.

Escopo lists.write · Conta na cota write

Corpo

Campo	Tipo	Observações
`name`	string	Até 60 caracteres.
`position`	integer	0 a 999.

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

Esquece uma pasta. As listas dentro dela ficam sem pasta e continuam existindo: arrumar uma estante não é jogar fora o que estava nela.

Escopo lists.write · Conta na cota write

POST/api/v1/lists

Cria uma lista. Responde 201.

Escopo lists.write · Conta na cota write

Corpo

Campo	Tipo	Observações
`name`obrigatório	string	Até 100 caracteres.
`description`	string	Até 500 caracteres.
`kind`	string	COLLECTION ou TIERLIST. Uma TIERLIST já nasce com cinco faixas: uma criada sem elas não teria onde pôr nada.
`visibility`	string	PUBLIC, FOLLOWERS ou PRIVATE.
`ranked`	boolean	Um ranking em vez de uma coleção.

GET/api/v1/lists/{id}

Uma lista com seus itens. Aceita o id ou o id público, e traz `owned`, para o cliente saber se pode escrever antes de tentar.

Escopo lists.read · Conta na cota read

PATCH/api/v1/lists/{id}

Renomeia uma lista ou altera descrição, visibilidade, ordenação e comments_scope, que aceita EVERYONE, FOLLOWERS ou NOBODY. folder_ids arquiva a lista nas pastas suas que vierem na lista, substituindo as anteriores: uma lista pode estar em várias, e uma lista vazia tira de todas. Arquivar não muda quem vê o quê.

Escopo lists.write · Conta na cota write

Corpo

Campo	Tipo	Observações
`name`	string	Até 120 caracteres.
`description`	string	Até 1000 caracteres.
`visibility`	string	PUBLIC, FOLLOWERS ou PRIVATE.
`ranked`	boolean	Se a ordem da lista é o ponto dela.
`folder_ids`	array	Os ids das suas pastas, até 40. Substitui o conjunto anterior, então [] tira a lista de todas. A pasta de outra pessoa é recusada pelo banco, e não por uma checagem escrita duas vezes.

DELETE/api/v1/lists/{id}

Remove uma lista.

Escopo lists.write · Conta na cota write

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

Salva as faixas de uma tierlist e onde cada jogo está, de uma vez. Não é um PATCH por item: uma tierlist só faz sentido inteira, e salvar uma faixa e o conteúdo dela separadamente deixaria um instante em que um jogo está numa faixa que ninguém definiu.

Escopo lists.write · Conta na cota write

Corpo

Campo	Tipo	Observações
`tiers`obrigatório	array	As faixas, cada uma com id, label, color e position. O id é seu, e não do banco: as faixas são reescritas inteiras a cada salvamento, e são os itens que precisam nomeá-las. Até 26.
`items`obrigatório	array	Cada jogo, com tier_id, igdb_id, game_slug e position. Um jogo que saiu da biblioteca do dono, ou cujo tier_id não está entre as faixas enviadas, é ignorado em silêncio em vez de derrubar o salvamento. Até 1000.

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

Adiciona um jogo a uma lista. Responde 201.

Escopo lists.write · Conta na cota write

Corpo

Campo	Tipo	Observações
`igdb_id`obrigatório	integer	O id do jogo no catálogo.
`game_slug`obrigatório	string	O slug do jogo.

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

Anota um item, muda a aparência dele na lista, ou o move de lugar. Posição e direção são dois jeitos de dizer a mesma coisa, então mande um ou outro.

Escopo lists.write · Conta na cota write

Corpo

Campo	Tipo	Observações
`note`	string	Até 500 caracteres.
`mark_mode`	string	COLOR ou DIM, ou null para tirar o destaque. É só aparência: o que ela significa é o autor que diz, na descrição da lista. O sistema não associa cor a estado nenhum.
`mark_color`	string	Com mark_mode COLOR: RED, ORANGE, YELLOW, GREEN, CYAN, BLUE, PURPLE, PINK ou NEUTRAL.
`marked`	boolean	Descontinuado. Era "concluído", que é um significado só entre muitos. true vira mark_mode DIM e false tira o destaque.
`position`	integer	A posição exata, contando de 0.
`direction`	string	up, down ou top, para mover sem saber a posição.

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

Tira um jogo da lista.

Escopo lists.write · Conta na cota write

Uma lista é alcançável pelo id ou pelo id público. A resposta traz owned, para o cliente saber se pode escrever antes de tentar.

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

Tierlist visível com capas. pool=1 inclui jogos disponíveis para o dono.

Escopo lists.read · Conta na cota read

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

Quem edita os jogos da lista com o dono, tão visível quanto a própria lista.

Escopo lists.read · Conta na cota read

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

Escopo lists.write · Conta na cota write

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

Remove um colaborador: profile_id na query. O dono remove qualquer um; um colaborador remove a si mesmo para sair.

Escopo lists.write · Conta na cota write

GET/api/v1/search/lists

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

Escopo lists.read · Conta na cota read

GET/api/v1/lists

As listas do dono.

Escopo lists.read · Conta na cota read

GET/api/v1/lists/folders

Escopo lists.read · Conta na cota read

POST/api/v1/lists/folders

Cria uma pasta. Pedir um nome que já existe devolve a pasta que já existe, e `created` diz o que aconteceu.

Escopo lists.write · Conta na cota write

Corpo

Campo	Tipo	Observações
`name`obrigatório	string	Até 60 caracteres.
`position`	integer	A ordem do dono, de 0 a 999. Alfabética não é o que ninguém quer dizer com as próprias estantes.

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

Renomeia uma pasta ou a move na ordem. Aceita o id ou o public_id. A pasta de outra pessoa não é recusada: ela simplesmente não existe para quem pergunta.

Escopo lists.write · Conta na cota write

Corpo

Campo	Tipo	Observações
`name`	string	Até 60 caracteres.
`position`	integer	0 a 999.

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

Esquece uma pasta. As listas dentro dela ficam sem pasta e continuam existindo: arrumar uma estante não é jogar fora o que estava nela.

Escopo lists.write · Conta na cota write

POST/api/v1/lists

Cria uma lista. Responde 201.

Escopo lists.write · Conta na cota write

Corpo

Campo	Tipo	Observações
`name`obrigatório	string	Até 100 caracteres.
`description`	string	Até 500 caracteres.
`kind`	string	COLLECTION ou TIERLIST. Uma TIERLIST já nasce com cinco faixas: uma criada sem elas não teria onde pôr nada.
`visibility`	string	PUBLIC, FOLLOWERS ou PRIVATE.
`ranked`	boolean	Um ranking em vez de uma coleção.

GET/api/v1/lists/{id}

Uma lista com seus itens. Aceita o id ou o id público, e traz `owned`, para o cliente saber se pode escrever antes de tentar.

Escopo lists.read · Conta na cota read

PATCH/api/v1/lists/{id}

Escopo lists.write · Conta na cota write

Corpo

Campo	Tipo	Observações
`name`	string	Até 120 caracteres.
`description`	string	Até 1000 caracteres.
`visibility`	string	PUBLIC, FOLLOWERS ou PRIVATE.
`ranked`	boolean	Se a ordem da lista é o ponto dela.
`folder_ids`	array	Os ids das suas pastas, até 40. Substitui o conjunto anterior, então [] tira a lista de todas. A pasta de outra pessoa é recusada pelo banco, e não por uma checagem escrita duas vezes.

DELETE/api/v1/lists/{id}

Remove uma lista.

Escopo lists.write · Conta na cota write

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

Escopo lists.write · Conta na cota write

Corpo

Campo	Tipo	Observações
`tiers`obrigatório	array	As faixas, cada uma com id, label, color e position. O id é seu, e não do banco: as faixas são reescritas inteiras a cada salvamento, e são os itens que precisam nomeá-las. Até 26.
`items`obrigatório	array	Cada jogo, com tier_id, igdb_id, game_slug e position. Um jogo que saiu da biblioteca do dono, ou cujo tier_id não está entre as faixas enviadas, é ignorado em silêncio em vez de derrubar o salvamento. Até 1000.

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

Adiciona um jogo a uma lista. Responde 201.

Escopo lists.write · Conta na cota write

Corpo

Campo	Tipo	Observações
`igdb_id`obrigatório	integer	O id do jogo no catálogo.
`game_slug`obrigatório	string	O slug do jogo.

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

Anota um item, muda a aparência dele na lista, ou o move de lugar. Posição e direção são dois jeitos de dizer a mesma coisa, então mande um ou outro.

Escopo lists.write · Conta na cota write

Corpo

Campo	Tipo	Observações
`note`	string	Até 500 caracteres.
`mark_mode`	string	COLOR ou DIM, ou null para tirar o destaque. É só aparência: o que ela significa é o autor que diz, na descrição da lista. O sistema não associa cor a estado nenhum.
`mark_color`	string	Com mark_mode COLOR: RED, ORANGE, YELLOW, GREEN, CYAN, BLUE, PURPLE, PINK ou NEUTRAL.
`marked`	boolean	Descontinuado. Era "concluído", que é um significado só entre muitos. true vira mark_mode DIM e false tira o destaque.
`position`	integer	A posição exata, contando de 0.
`direction`	string	up, down ou top, para mover sem saber a posição.

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

Tira um jogo da lista.

Escopo lists.write · Conta na cota write