Baixa os números de Feedbacks em CSV ou Excel
GET/api/feedbacks/dashboard/export
- Auth
- Exige token
- Chave de API:
- Não aceita chave de API
- X-CommunityId
X-CommunityIdEnvie o X-CommunityId da comunidade em que a operação acontece.
Owner e admin (membro, moderador e financeiro: 403). Acima de 2.000 linhas responde 202 e o arquivo chega por e-mail (veja a resposta 202). Os mesmos números de `GET /api/feedbacks/dashboard`, com os mesmos filtros (`from`, `to`, `groupId`, `spaceId`) e as mesmas proteções: só números e nomes do catálogo de temas, nunca texto, autor ou destinatário; contagem de tema abaixo de 3 sai como "< 3"; com `groupId`, sem a divisão por tema. Uma linha por número (seção, número, valor), rótulos no idioma do `Accept-Language`. `format`: `csv` (UTF-8 com BOM) ou `xlsx`.
Parâmetros
| Nome | Onde | Tipo | Descrição |
|---|---|---|---|
formatobrigatório | query | csv | xlsx | |
fromopcional | query | string (date) | |
toopcional | query | string (date) | |
groupIdopcional | query | string (uuid) | |
spaceIdopcional | query | string (uuid) |
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 | O arquivo (`Content-Disposition` com `feedbacks-AAAA-MM-DD_AAAA-MM-DD.csv|xlsx`). |
202 | Exportação grande (mais de 2.000 linhas): o arquivo não vem na resposta. Ele é gerado numa fila com os mesmos filtros, guardado de forma privada e o link (válido por 72 horas) vai por e-mail para quem pediu. `data.email` é o endereço que recebe; se a pessoa perder o papel antes da geração, recebe um aviso de falha em vez do link. |
400 | Requisição inválida — falha de validação. |
401 | Token ausente, inválido ou expirado; token de outra comunidade (o `X-CommunityId` ou o `communityId` do corpo não é o do token); token antigo ou de uma sessão encerrada (troca de senha, convite aceito). Nesses casos a mensagem pede para entrar de novo (`auth.signInAgain`). |
403 | Autenticado, mas sem permissão para esta operação. |
404 | Recurso não encontrado. |
422 | Data inválida, `to` antes de `from`, período acima de 366 dias ou grupo de outra comunidade. |
Exemplo com curl
curl -X GET "https://api.memberfy.net/api/feedbacks/dashboard/export" \
-H "Authorization: Bearer $TOKEN" \
-H "X-CommunityId: $COMMUNITY_ID"