Baixa os números de Feedbacks em CSV ou Excel
GET/api/feedbacks/dashboard/export
- Auth
- Richiede un token
- Chiave API:
- Non accetta chiavi API
- X-CommunityId
X-CommunityIdInvia l’X-CommunityId della community in cui avviene l’operazione.
Le descrizioni degli endpoint provengono dalla specifica dell’API e per ora sono in portoghese. L’interfaccia intorno è tradotta.
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`.
Parametri
| Nome | Dove | Tipo | Descrizione |
|---|---|---|---|
formatobbligatorio | query | csv | xlsx | |
fromfacoltativo | query | string (date) | |
tofacoltativo | query | string (date) | |
groupIdfacoltativo | query | string (uuid) | |
spaceIdfacoltativo | query | string (uuid) |
Header
| Nome | Tipo | Descrizione |
|---|---|---|
X-CommunityIdfacoltativo | string (uuid) | ID da comunidade em que a operação acontece. Obrigatório na maioria dos endpoints com escopo de comunidade. |
Risposte
| Codice | Descrizione |
|---|---|
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. |
Esempio con curl
curl -X GET "https://api.memberfy.net/api/feedbacks/dashboard/export" \
-H "Authorization: Bearer $TOKEN" \
-H "X-CommunityId: $COMMUNITY_ID"