Ctrlk
For the complete documentation index, see llms.txt. This page is also available as Markdown.

Publicação de nova transmissão

Para o uso desse endpoint é necessário que suas credenciais de acesso tenham permissão para o uso do OAuth 2.0 para autorização.

POST https://eduplay.rnp.br/services/transmission/publish/{identifierOrigin}

Path Parameters

Name
Type
Description

identifierOrigin*

String

identificador único do vídeo no sistema de origem

Request Body

Name
Type
Description

transmission*

transmissionMetadata

parâmetro do tipo multipart com as informações da transmissão a ser salva, conforme formato do tipo transmissionMetadata, definido na descrição dos serviços em api-docs.

thumbnail*

binary

parâmetro do tipo multipart: arquivo com a imagem da transmissão (screenshot). Deve conter no cabeçalho o Content-Disposition com o respectivo filename.

<returnMessage>
	<operationCode>CODIGO_DA_OPERACAO_DE_SUCESSO_OU_ERRO</operationCode>
	<message>MENSAGEM_EXPLICATIVA</message>
	<result>{"id":ID_TRANSMISSAO,"status":"ACTIVE|PENDING_APPROVAL","message":"MOTIVO DE ENVIO PARA MODERACAO"}</result> <!-- em caso de sucesso -->
	<result>DETALHES_ERRO</result> <!-- em caso de erro e existam detalhes necessários -->
</returnMessage>

Considerações sobre os metadados para a nova transmissão:

  • As informações obrigatórias são: title, description, audienceExpected, transmissionRate e schedules (pelo menos um).

  • É possível definir controle de acesso por geolocalização (geoblocking) por meio do atributo geolocationControl com os valores possíveis: NONE e BRAZIL, para definir acesso sem geoblocking ou apenas em território brasileiro, respectivamente.

  • É possível definir as seguintes opções de visibilidade:

    • PUBLIC - acesso público tanto pelo eduplay como por embed

    • PUBLIC_REFERENCED - acesso apenas por embed. O vídeo não será listado nas páginas e nem retornado na busca no eduplay

    • PRIVATE - acesso apenas a usuários autenticados no eduplay. É possível também permitir o acesso aos usuários não-autenticados por meio da definição de uma senha específica para esse fim no atributo password.

    • PRIVATE_RESTRICT_BY_PASSWORD - acesso restrito por senha específica para o conteúdo. Ao definir esse tipo de acesso, é obrigatório o envio da senha no atributo password.

    • PRIVATE_RESTRICT_BY_CHANNEL - acesso restrito apenas aos membros dos canais associados ao conteúdo.

  • É possível definir uma lista de canais aos quais a transmissão deve ser associada, por meio do elemento channels. Os canais devem já existir no eduplay e o usuário em nome do qual está sendo publicado o conteúdo deve ser dono ou membro com permissão para publicação no mesmo. Para saber em quais canais o usuário pode publicar utilizar o endpoint Canais que um usuário pode publicar. Exemplo de definição do elemento channels em formato XML:

    <channels>
	<channel><id>123</id></channel>
	<channel><id>345</id></channel>
</channels>
PreviousContabilização de acessos a uma transmissão a partir do identificador no eduplayNextAtualização dos dados de uma transmissão preexistente

Last updated

Was this helpful?