Saltar para o conteúdo

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-CommunityId Envie 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

NomeOndeTipoDescrição
formatobrigatórioquerycsv | xlsx
fromopcionalquerystring (date)
toopcionalquerystring (date)
groupIdopcionalquerystring (uuid)
spaceIdopcionalquerystring (uuid)

Headers

NomeTipoDescrição
X-CommunityIdopcionalstring (uuid)ID da comunidade em que a operação acontece. Obrigatório na maioria dos endpoints com escopo de comunidade.

Respostas

CódigoDescrição
200O arquivo (`Content-Disposition` com `feedbacks-AAAA-MM-DD_AAAA-MM-DD.csv|xlsx`).
202Exportaçã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.
400Requisição inválida — falha de validação.
401Token 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`).
403Autenticado, mas sem permissão para esta operação.
404Recurso não encontrado.
422Data 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"