Lista de chamados
GET/api/support/tickets
- Auth
- Exige token
- X-CommunityId
X-CommunityIdEnvie o X-CommunityId da comunidade em que a operação acontece.
A equipe vê a fila inteira da comunidade; **o residente só os próprios** e os filtros de equipe (`assigneeId`, `requesterId`, `unassigned`, `mine`, `overdue`, `dueToday`) são ignorados, sem erro. Filtros: `spaceId`, `kind`, `status`, `priority` e `category` (um valor, vários repetidos ou separados por vírgula), `assigneeId`, `unassigned`, `resourceId`, `requesterId`, `mine`, `q` (número, `#42` ou parte do título), `sort` (`priority` ordena por prioridade e depois pela atividade; o padrão é a atividade mais recente). Paginado. Só a equipe: `overdue=true` (prazo vencido e relógio rodando; `WAITING_REQUESTER` não conta) e `dueToday=true` (o próximo prazo vence hoje, no fuso da comunidade); só em spaces com SLA ligado.
Parâmetros
| Nome | Onde | Tipo | Descrição |
|---|---|---|---|
spaceIdopcional | query | string (uuid) | |
kindopcional | query | MAINTENANCE | REQUEST | |
statusopcional | query | string | |
priorityopcional | query | string | |
categoryopcional | query | string | |
assigneeIdopcional | query | string (uuid) | |
unassignedopcional | query | boolean | |
resourceIdopcional | query | string (uuid) | |
requesterIdopcional | query | string (uuid) | |
mineopcional | query | boolean | |
overdueopcional | query | boolean | |
dueTodayopcional | query | boolean | |
qopcional | query | string | |
sortopcional | query | activity | priority | |
pageopcional | query | integer | |
limitopcional | query | integer |
Headers
| Nome | Tipo | Descrição |
|---|---|---|
X-CommunityIdopcional | string (uuid) | ID da comunidade em que a operação acontece. Obrigatório na maioria dos endpoints com escopo de comunidade. |
Respostas
| Código | Descrição |
|---|---|
200 | Chamados da página. |
400 | Requisição inválida — falha de validação. |
401 | Token ausente, inválido ou expirado. |
403 | Autenticado, mas sem permissão para esta operação. |
404 | Recurso não encontrado. |
500 | Erro interno do servidor. |
Exemplo com curl
curl -X GET "https://api.memberfy.net/api/support/tickets" \
-H "Authorization: Bearer $TOKEN" \
-H "X-CommunityId: $COMMUNITY_ID"