Configure Carteiro para Serviços de Mídia v3 REST Chamadas API

logotipo de serviços de mídia v3


Este artigo mostra-lhe como configurar o Carteiro para que possa ser usado para chamar APIs de REST da Azure Media Services (AMS). O artigo mostra como importar ambiente e recolha de ficheiros para o Carteiro. A coleção contém definições agrupadas de pedidos HTTP que chamam Azure Media Services (AMS) REST APIs. O ficheiro de ambiente contém variáveis que são utilizadas pela coleção.

Antes de começar a desenvolver,reveja o Desenvolvimento com os Serviços de Media v3 APIs.

Pré-requisitos

  • Criar uma conta de Serviços de ComunicaçãoSocial. Lembre-se do nome do grupo de recursos e do nome da conta dos Serviços de Comunicação Social.

  • Obtenha informações necessárias para aceder a APIs

  • Instale o cliente REST do Postman para executar as API REST mostradas em alguns dos tutoriais sobre AMS REST.

    Estamos a utilizar o Postman, mas qualquer ferramenta REST seria adequada. Outras alternativas são: Código de Estúdio Visual com o plugin REST ou o Fiddler Telerik.

Importante

Rever convenções de nomeação.

Transferir ficheiros do Postman

Clone o repositório do GitHub que contém os ficheiros de ambiente e coleção do Postman.

git clone https://github.com/Azure-Samples/media-services-v3-rest-postman.git

Configurar o Postman

Configurar o ambiente

  1. Abra a aplicação do Carteiro.

  2. À direita do ecrã, selecione a opção Gerir ambiente.

    Gerir ambiente

  3. Na caixa de diálogo Gerir ambiente, clique em Importar.

  4. Navegue até ao ficheiro Azure Media Service v3 Environment.postman_environment.json que foi transferido quando clonou https://github.com/Azure-Samples/media-services-v3-rest-postman.git.

  5. O ambiente Ambiente v3 do Serviço de Multimédia do Azure é adicionado.

    Nota

    Atualize as variáveis de acesso com valores obtidos na secção Aceder à API dos Serviços de Multimédia acima.

  6. Faça duplo clique no ficheiro selecionado e introduza os valores que obteve após seguir os passos de Acesso à API.

  7. Feche a caixa de diálogo.

  8. Selecione o Ambiente v3 do Serviço de Multimédia do Azure na lista pendente.

    Escolher ambiente

Configurar a coleção

  1. Clique em Importar para importar o ficheiro de coleção.

  2. Navegue até ao ficheiro Media Services v3.postman_collection.json que foi transferido quando clonou https://github.com/Azure-Samples/media-services-v3-rest-postman.git

  3. Escolha o ficheiro Media Services v3.postman_collection.json.

    Importar um ficheiro

Obter o Token do Microsoft Azure AD

Antes de começar a manipular os recursos AMS v3, precisa de obter e definir Azure AD Token para a Autenticação Principal do Serviço.

  1. Na janela esquerda da aplicação Postman, selecione "Passo 1: Obter ficha AAD Auth".

  2. Em seguida, selecione "Obter o Token do Microsoft Azure AD para Autenticação Principal de Serviço".

  3. Prima Enviar.

    A seguinte operação POST é enviada.

    https://login.microsoftonline.com/:tenantId/oauth2/token
    
  4. A resposta volta com o token e define a variável de ambiente "AccessToken" como o valor de token.

    Obter token do AAD

Resolução de problemas

  • Se a sua aplicação falhar com "HTTP 504: Gateway Timeout", certifique-se de que a variável de localização não foi explicitamente definida para outro valor que não a localização esperada da conta Serviços de Comunicação.
  • Se obtém um erro de "conta não encontrada", verifique também se a propriedade de localização na mensagem Body JSON está definida para o local onde se encontra a conta dos Serviços de Comunicação Social.

Ver também

Passos seguintes