Edita um episódio
PUT/api/media-episodes/{id}
- Auth
- Jeton requis
- Qui peut l’appeler:
- owner
- admin
- Clé d’API:
- podcasts:write
- X-CommunityId
X-CommunityIdEnvoyez le X-CommunityId de la communauté où l’opération a lieu.
Les descriptions des endpoints viennent directement de la spécification de l’API et sont en portugais pour l’instant. L’interface autour est traduite.
Owner, admin ou apresentador do programa (403 em outro programa). O arquivo substituído é apagado; um reaproveitado só deixa de ser usado aqui.
Paramètres
| Nom | Emplacement | Type | Description |
|---|---|---|---|
idobligatoire | path | string (uuid) |
En-têtes
| Nom | Type | Description |
|---|---|---|
X-CommunityIdfacultatif | string (uuid) | ID da comunidade em que a operação acontece. Obrigatório na maioria dos endpoints com escopo de comunidade. |
Corps de la requête application/json
| Nom | Type | Description |
|---|---|---|
titlefacultatif | string | max 200 |
descriptionfacultatif | string | |
seasonfacultatif | integer | ≥ 1 |
numberfacultatif | integer | ≥ 0 |
typefacultatif | full | trailer | bonus | |
isOpenfacultatif | boolean | |
audioMediaIdfacultatif | string (uuid) | |
videoMediaIdfacultatif | string (uuid) | |
coverMediaIdfacultatif | string (uuid) | |
durationSecondsfacultatif | integer | |
chaptersfacultatif | object[] | Sobrepõem os da descrição; nulo volta a ler a descrição. |
chapters[].startSecondsfacultatif | integer | |
chapters[].titlefacultatif | string | max 120 |
Réponses
| Statut | Description |
|---|---|
200 | O episódio. |
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. |
404 | Recurso não encontrado. |
409 | Conflito com o estado atual do recurso. |
Exemple curl
curl -X PUT "https://api.memberfy.net/api/media-episodes/<id>" \
-H "Authorization: Bearer $TOKEN" \
-H "X-CommunityId: $COMMUNITY_ID" \
-H "Content-Type: application/json" \
-d '{}'