Ao usar o Intelligent Media Services (IMS) para upload de ativos de mídia, processamento de mídia e edição online, configure eventos de callback para receber atualizações oportunas sobre o progresso e o status das tarefas. Assim, você coordena as operações de negócio subsequentes.
Métodos de callback
Introdução
O IMS oferece dois métodos de callback para recebimento de notificações de eventos: requisições HTTP e filas MNS.
Requisição HTTP: o IMS envia notificações de eventos diretamente ao seu serviço. Implante um serviço HTTP para receber as mensagens de callback e defina uma URL de callback no console ou por chamada de API. Quando um evento ocorre, o servidor IMS envia uma requisição HTTP POST para a URL de callback com o conteúdo da mensagem no corpo da requisição.
Fila MNS: o IMS grava as notificações de eventos em uma fila de mensagens. Autorize o IMS a acessar o Simple Message Queue (formerly MNS), crie ou selecione uma fila existente e configure o nome da fila no console ou por chamada de API. Ao ocorrer um evento, o IMS grava o conteúdo do callback na fila. Leia a fila para recuperar as mensagens.
Vantagens e desvantagens
|
Comparação |
Requisição HTTP |
Fila MNS |
|
Confiabilidade |
As mensagens podem ser perdidas se o serviço HTTP receptor apresentar problemas, como falhas ou reinicializações. |
Com a configuração correta, os callbacks de mensagens têm sucesso quase absoluto. Este método oferece maior confiabilidade. |
|
Segurança |
Qualquer cliente HTTP pode enviar uma requisição para a URL de callback. Use a autenticação de callback para filtrar requisições não autorizadas. Para mais informações, consulte Autenticação de callback. |
Apenas partes autorizadas podem ler e escrever na fila de mensagens. Esta abordagem proporciona maior segurança. |
|
Praticidade |
Mais simples de configurar. Basta implantar um serviço para receber as mensagens. |
Exige a ativação e configuração do MNS. Além disso, desenvolva e implante um programa para consumir as mensagens. |
Protocolos de callback
|
Método de callback |
Descrição |
|
Requisição HTTP |
|
|
Fila MNS |
As mensagens recebidas da fila são strings JSON. Para exemplos do corpo da mensagem e descrições dos parâmetros, consulte Lista de eventos. |
Validação e novas tentativas de callback
|
Método de callback |
O callback foi bem-sucedido? |
Novas tentativas de callback |
|
Requisição HTTP |
O callback é bem-sucedido se o serviço receptor responder com o código de status HTTP 200. Falha caso o código de status seja diferente de 200 ou o tempo de resposta exceda 3 segundos. O IMS determina o sucesso apenas pelo código de status HTTP e ignora o corpo da resposta. |
Se o callback falhar devido a um problema de configuração, como URL de callback incorreta ou serviço receptor indisponível, o IMS tenta mais duas vezes em intervalos de 1 segundo. Caso todas as três tentativas falhem, a mensagem será descartada. |
|
Fila MNS |
O callback é bem-sucedido quando a mensagem é gravada corretamente na fila MNS. Caso contrário, o callback falha. |
Se a gravação da mensagem na fila MNS falhar por questões de configuração, o IMS tenta mais duas vezes em intervalos de 1 segundo. Problemas comuns incluem não conceder acesso ao IMS para o Simple Message Queue (formerly MNS), usar um endereço de fila fora da rede pública ou especificar um nome de fila incorreto. Se todas as três tentativas falharem, a mensagem será descartada. |
Os callbacks via fila MNS oferecem maior confiabilidade. Com a configuração adequada, o envio das mensagens tem sucesso praticamente garantido.
Tipos de eventos de callback
O IMS disponibiliza eventos de callback para upload de ativos de mídia, processamento de mídia, edição online, entre outras operações. Configure eventos específicos para obter atualizações oportunas sobre o andamento e o status das tarefas. Para mais detalhes, consulte Lista de eventos.