Zum Inhalt springen

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

GET/api/media/library

Auth
Token erforderlich
Wer darf:
owner
admin
moderator
finance
API-Schlüssel:
media:read
X-CommunityId
X-CommunityId Sende die X-CommunityId der Community, in der die Operation stattfindet.
Die Beschreibungen der Endpoints stammen aus der API-Spezifikation und sind vorerst auf Portugiesisch. Die Oberfläche drumherum ist übersetzt.

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`).

Parameter

NameOrtTypBeschreibung
kindoptionalqueryaudio | videoFiltro por tipo.
qoptionalquerystringParte do nome do arquivo.
foroptionalqueryepisode | status | content | lessonO 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).
pageoptionalqueryinteger
limitoptionalqueryinteger

Header

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

Antworten

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

curl-Beispiel

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