Baixa os números de Feedbacks em CSV ou Excel
GET/api/feedbacks/dashboard/export
- Auth
- Requires a token
- API key:
- No API key accepted
- X-CommunityId
X-CommunityIdSend the X-CommunityId of the community the operation happens in.
Endpoint descriptions come straight from the API specification and are in Portuguese for now. The interface around them is translated.
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`.
Parameters
| Name | In | Type | Description |
|---|---|---|---|
formatrequired | query | csv | xlsx | |
fromoptional | query | string (date) | |
tooptional | query | string (date) | |
groupIdoptional | query | string (uuid) | |
spaceIdoptional | query | string (uuid) |
Headers
| Name | Type | Description |
|---|---|---|
X-CommunityIdoptional | string (uuid) | ID da comunidade em que a operação acontece. Obrigatório na maioria dos endpoints com escopo de comunidade. |
Responses
| Status | Description |
|---|---|
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. |
curl example
curl -X GET "https://api.memberfy.net/api/feedbacks/dashboard/export" \
-H "Authorization: Bearer $TOKEN" \
-H "X-CommunityId: $COMMUNITY_ID"