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-CommunityIdSende die X-CommunityId der Community, in der die Operation stattfindet.
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
| Name | Ort | Typ | Beschreibung |
|---|---|---|---|
kindoptional | query | audio | video | Filtro por tipo. |
qoptional | query | string | Parte do nome do arquivo. |
foroptional | 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). |
pageoptional | query | integer | |
limitoptional | query | integer |
Header
| Name | Typ | Beschreibung |
|---|---|---|
X-CommunityIdoptional | string (uuid) | ID da comunidade em que a operação acontece. Obrigatório na maioria dos endpoints com escopo de comunidade. |
Antworten
| Status | Beschreibung |
|---|---|
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. |
curl-Beispiel
curl -X GET "https://api.memberfy.net/api/media/library" \
-H "Authorization: Bearer $TOKEN" \
-H "X-CommunityId: $COMMUNITY_ID"