Baixa os números de Feedbacks em CSV ou Excel
GET/api/feedbacks/dashboard/export
- Auth
- Requiere token
- Clave de API:
- No acepta clave de API
- X-CommunityId
X-CommunityIdEnvía el X-CommunityId de la comunidad en la que ocurre la operación.
Las descripciones de los endpoints vienen de la especificación de la API y, por ahora, están en portugués. La interfaz alrededor está traducida.
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
| Nombre | Dónde | Tipo | Descripción |
|---|---|---|---|
formatobligatorio | query | csv | xlsx | |
fromopcional | query | string (date) | |
toopcional | query | string (date) | |
groupIdopcional | query | string (uuid) | |
spaceIdopcional | query | string (uuid) |
Headers
| Nombre | Tipo | Descripción |
|---|---|---|
X-CommunityIdopcional | string (uuid) | ID da comunidade em que a operação acontece. Obrigatório na maioria dos endpoints com escopo de comunidade. |
Respuestas
| Código | Descripción |
|---|---|
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. |
Ejemplo con curl
curl -X GET "https://api.memberfy.net/api/feedbacks/dashboard/export" \
-H "Authorization: Bearer $TOKEN" \
-H "X-CommunityId: $COMMUNITY_ID"