Saltar al contenido

Consumo do RSS de Podcast e Vídeos

GET/api/analytics/media-feeds

Auth
Requiere token
Clave de API:
reports:read
X-CommunityId
X-CommunityId Envía el X-CommunityId de la comunidad en la que ocurre la operación.
Las descripciones de los endpoints vienen de la especificación de la API y, por ahora, están en portugués. La interfaz alrededor está traducida.

Só **owner e admin** (moderador, financeiro e membro: 403). O consumo pelos apps de podcast no período: **downloads** (no máximo um por link pessoal, ou por endereço e app, a cada 24 h; separados dos plays do app e do embed), **ouvintes** por feed (público: endereço e app distintos; pessoal: links distintos), os **apps** mais usados (lidos do user agent: `apple_podcasts`, `spotify`, `overcast`, `pocket_casts`, `castbox`, `podcast_addict`, `antennapod`, `castro`, `amazon_music`, `youtube_music`, `deezer`, `podbean`, `player_fm`, `iheartradio`, `downcast`, `browser`, `other`) e o **volume entregue** em bytes (estimativa: o tamanho do arquivo por download), no total, por dia, por programa e por episódio (os 100 com mais downloads). A medição é para insights: a entrega do RSS nunca é cortada nem limitada por plano. Sem `from`, os últimos 30 dias até `to` (padrão hoje), no fuso da comunidade. `showId`/`episodeId` filtram (de outra comunidade: 404).

Parámetros

NombreDóndeTipoDescripción
fromopcionalquerystring (date)
toopcionalquerystring (date)
showIdopcionalquerystring (uuid)
episodeIdopcionalquerystring (uuid)

Headers

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

Respuestas

CódigoDescripción
200O consumo do RSS.
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.
500Erro interno do servidor.

Ejemplo con curl

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