Listar tags

GEThttps://api.picchat.com.br/v1/tags

Lista as tags de tíquete da conta (excluídas ficam de fora), cada uma com o canal a que pertence. Ordem fixa por order e depois nome; não aceita order. Não aplica o escopo de canais do usuário.

Autenticação: Bearer tokenPermissão: Inbox › ver ou Contatos › ver

Parâmetros de consulta (query)

pageintegerpadrão 1
Página, começando em 1. Valor ausente, inválido ou menor que 1 vira 1.
limitintegerpadrão 20
Itens por página. Padrão 20, máximo 100: acima disso é reduzido para 100 sem erro; valor inválido ou menor que 1 vira 20.
channel_idstring (uuid)
Só tags deste canal.
searchstring
Busca parcial no nome, sem diferenciar maiúsculas.

Respostas

200OK

itemsarray<Tag>obrigatório
Registros da página.
items[].idstring (uuid)obrigatório
ID da tag.
items[].namestringobrigatório
Nome.
items[].descriptionstring | nullobrigatório
Descrição.
items[].colorstring | nullobrigatório
Cor.
items[].orderinteger | nullobrigatório
Ordem de exibição.
items[].created_atstring (date-time)obrigatório
Criação.
items[].channelsobjectobrigatório
Canal resumido (sem tipo).
items[].channels.idstring (uuid)obrigatório
ID do canal.
items[].channels.namestringobrigatório
Nome do canal.
totalintegerobrigatório
Total de registros que casam com os filtros (todas as páginas).
pageintegerobrigatório
Página devolvida (começa em 1).
limitintegerobrigatório
Itens por página efetivamente usados (1–100).
pagesintegerobrigatório
Total de páginas: `max(1, ceil(total / limit))`. Nunca é 0, mesmo sem resultados.

403Acesso negado: usuário do token sem a permissão da rota (`permission_denied`) ou token não ligado a um usuário ativo (`token_without_user`) — para token de integração da conta isso só é aplicado quando `access.enforced` é true (veja GET /v1/me); token pessoal e JWT de sessão são sempre verificados; `account_id` na query diferente da conta do token; conta do tipo INFRA.

498Token ausente, inválido, de outra finalidade (ex.: token do canal chat) ou revogado. Note o status não padrão 498.