Este conteúdo foi traduzido por máquina para sua conveniência e a Huawei Cloud não pode garantir que o conteúdo foi traduzido com precisão. Para exibir o conteúdo original, use o link no canto superior direito para mudar para a página em inglês.

Central de ajuda/ Meeting/ Referência de API do servidor/ Gerenciamento do quadro de avisos/ Gerenciamento de programa do quadro de avisos/ Consulta de detalhes do programa por ID

Atualizado em 2023-08-02 GMT+08:00

Ver PDF

Consulta de detalhes do programa por ID

Descrição

Esta API é usada para consultar detalhes do programa por ID.

Depuração

Você pode depurar essa API no API Explorer.

Protótipo

**Tabela 1** Protótipo
Método de solicitação	GET
Endereço de solicitação	/v1/usg/sss/programs/{id}
Protocolo de transporte	HTTPS

Parâmetros de solicitação

**Tabela 2** Parâmetros
Parâmetro	Obrigatório	Tipo	Localização	Descrição
id	Sim	String	Caminho	ID do programa.
X-Access-Token	Sim	String	Cabeçalho	Token de autorização. Use o valor de accessToken na resposta à solicitação de Autenticação de um ID de aplicação.
X-Request-Id	Não	String	Cabeçalho	ID da solicitação, que é usado para rastreamento e localização de falhas. É aconselhável usar um UUID. Se este parâmetro não for transportado, um ID de solicitação é gerado automaticamente.
Accept-Language	Não	String	Cabeçalho	Idioma. Valores: zh-CN para chinês (padrão) e en-US para inglês.

Códigos de status

**Tabela 3** Códigos de status
Código de status HTTP	Descrição
200	Operação bem-sucedida.
400	Parâmetros inválidos.
401	A autenticação não é executada ou falha.
403	Permissões insuficientes.
500	Exceção do servidor.

Parâmetros de resposta

**Tabela 4** Parâmetros de resposta
Parâmetro	Tipo	Descrição
id	String	ID do programa.
lastUpdatedBy	String	Atualizador.
materialSizeStr	String	Tamanho total dos materiais do programa (incluindo a unidade).
playTime	Integer	Duração total da reprodução de um programa, em segundos.
programName	String	Nome do programa.
updateTime	Long	Hora da atualização.
programItemList	Array of ProgramItemResponseBase objects	Lista de material do programa.

**Tabela 5** Estrutura de dados ProgramItemResponseBase
Parâmetro	Tipo	Descrição
filePath	String	Caminho para baixar um material do Clouddrive.
materialId	String	ID do material.
materialName	String	Nome do material.
playTime	Integer	Duração da reprodução.

Exemplo de solicitação

GET /v1/usg/sss/programs/6cffb6ffbb6049d1b21c1c4e39fcb2e0
Connection: keep-alive
X-Access-Token: cnrfzn5OLRjwoaOf2F7PfMwVjJ6zScFogbDE
Host: api.meeting.huaweicloud.com 
User-Agent: Apache-HttpClient/4.5.3 (Java/1.8.0_191)

Exemplo de resposta

HTTP/1.1 200 
Date: Wed, 18 Dec 2019 06:20:40 GMT
Content-Type: application/json;charset=UTF-8
Connection: keep-alive
Pragma: No-cache
Cache-Control: no-cache
Server: api-gateway
X-Request-Id: a69e8b71ds78987ffc5eb844bsd5ca97

{
    "id": "0b95f012274443a1bb0a223c131284a6",
    "lastUpdatedBy": "",
    "updateTime": 1593538299852,
    "programName": "LhL85eKrB9",
    "materialSizeStr": "462.71KB",
    "playTime": 10,
    "programItemList": [
        {
            "materialId": "c704066824c74dd79afc2e66f433b186",
            "materialName": "20200616165610218test_upload_material",
            "filePath": "https://mock/download-file",
            "playTime": 10
        }
    ]
}

Códigos de erro

Se um código de erro começando com MMC ou USG for retornado quando você usar essa API, corrija a falha seguindo as instruções fornecidas no Centro de erros da API da Huawei Cloud.

Exemplo de comando cURL

curl -k -i -X GET -H 'X-Access-Token: cnrfzn5OLRjwoaOf2F7PfMwVjJ6zScFogbDE' https://api.meeting.huaweicloud.com/v1/usg/sss/programs/6cffb6ffbb6049d1b21c1c4e39fcb2e0

Tópico principal: Gerenciamento de programa do quadro de avisos

Tópico anterior: Consulta de programas do quadro de avisos

Próximo tópico: Atualização de um programa do quadro de avisos