Link de download de uma exportação grande

GET/api/exports/{exportId}/download

Auth: Richiede un token
Chi può:: owner; admin; finance
Chiave API:: Non accetta chiavi API
X-CommunityId: X-CommunityId Invia 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.

Exportações acima de 2.000 linhas (assinaturas, extrato de engajamento, painel de feedbacks) são geradas pela fila e respondem 202 com `exportId`; quando o arquivo fica pronto, quem pediu recebe um e-mail com o link do app (`/exports/{exportId}`), e o app chama esta rota. Só quem pediu a exportação, na comunidade do X-CommunityId e ainda com o papel que aquele tipo exige hoje (assinaturas: owner, admin ou finance; extrato de engajamento: equipe; feedbacks: owner ou admin), recebe um URL assinado que vale 5 minutos (`url`, até `urlExpiresAt`). O arquivo fica disponível até `expiresAt` (72 h depois de gerado) e é apagado nesse momento. Com `redirect=true` a resposta é um 302 direto para o arquivo. Exportação de outra pessoa, de outra comunidade ou sem o papel responde 404; ainda sendo gerada, 409; expirada, 410.

Parametri

Nome	Dove	Tipo	Descrizione
`exportId`obbligatorio	path	`string (uuid)`
`redirect`facoltativo	query	`boolean`	`true` responde 302 para o arquivo em vez do JSON.

Header

Nome	Tipo	Descrizione
`X-CommunityId`facoltativo	`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`	URL assinado do arquivo
`302`	Com `redirect=true`, redireciona para o URL assinado
`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`	Exportação não encontrada (ou de outra pessoa, ou sem o papel)
`409`	A exportação ainda está sendo gerada
`410`	A exportação expirou e o arquivo foi apagado

Esempio con curl

curl -X GET "https://api.memberfy.net/api/exports/<exportId>/download" \
  -H "Authorization: Bearer $TOKEN" \
  -H "X-CommunityId: $COMMUNITY_ID"