Biblioteca de mídia (seletor "Da biblioteca")

GET/api/media/library

Auth: Richiede un token
Chi può:: owner; admin; moderator; finance
Chiave API:: media:read
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.

Os áudios e vídeos da comunidade que podem ser reaproveitados (F-178 1b): de posts, Drops, aulas, gravações de evento, episódios e do "Podcast"/"Vídeo" do Feed. **Nunca** fotos (encomenda, suporte, galeria, capas) nem vídeos do chat. A equipe (owner, admin, moderador, financeiro) vê tudo; os demais, só o que eles mesmos enviaram. Mais novos primeiro. Para usar um arquivo, mande o `id` no campo de mídia do destino: `videoMediaId`/`audioMediaId` do post curto (`POST /api/status`), `videoMediaId` do post de Conteúdo e da aula, `audioMediaId`/`videoMediaId` do episódio. O arquivo não é copiado: armazenamento, conversão e transcrição contam uma vez. Um arquivo com uso pago (episódio, aula de curso pago, gravação de evento pago, post ou espaço de plano) só vai a outro episódio; no Feed, um episódio entra como cartão (`episodeId`).

Parametri

Nome	Dove	Tipo	Descrizione
`kind`facoltativo	query	`audio \| video`	Filtro por tipo.
`q`facoltativo	query	`string`	Parte do nome do arquivo.
`for`facoltativo	query	`episode \| status \| content \| lesson`	O destino do seletor: deixa só o que ele aceita. `content` e `lesson` só vídeo; fora de `episode` saem os arquivos de episódio (os outros de uso pago vêm com `paidOrigin: true` e `reusableIn` sem esse destino).
`page`facoltativo	query	`integer`
`limit`facoltativo	query	`integer`

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`	Página da biblioteca.
`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.
`500`	Erro interno do servidor.

Esempio con curl

curl -X GET "https://api.memberfy.net/api/media/library" \
  -H "Authorization: Bearer $TOKEN" \
  -H "X-CommunityId: $COMMUNITY_ID"