Saiba como configurar as configurações do dispositivo por meio da API HTTP usando o Postman, incluindo registro SIP, chaves DSS, opções de rede, formato de solicitação XML e recuperação de parâmetros com suporte
Este guia explica como configurar os parâmetros do dispositivo através da API HTTP, incluindo configurações do servidor SIP, detalhes de registro da conta SIP, parâmetros da tecla DSS e outras opções do dispositivo. O dispositivo atua como servidor HTTP, enquanto o cliente envia solicitações HTTP específicas para aplicar alterações de configuração, conforme mostrado no diagrama abaixo.
Neste exemplo, o Postman é usado para simular solicitações HTTP enviadas ao dispositivo.
Todos os modelos de telefone atualmente disponíveis em nossa linha de produtos.
① Um dispositivo de interfone BHP-SOS11V, atualizado para a versão de firmware mais recente e conectado a um switch PoE.
② Um PC de configuração com Postman instalado, conectado ao mesmo switch, com comunicação de rede normal confirmada.
Baixe o Postman de:
https://www.postman.com/downloads/
Em seguida, siga as instruções de instalação para concluir a configuração.
Clique em File – New, em seguida, selecione HTTP Request.
Na janela de nova solicitação, selecione o método POST e insira a URL HTTP do dispositivo no seguinte formato:
http://ip/xmlservice
Observe que a URL diferencia maiúsculas de minúsculas. Substitua ip pelo endereço IP real do dispositivo, conforme mostrado abaixo.
Em seguida, configure os parâmetros de solicitação HTTP necessários:
Método de autenticação: Basic Auth
Cabeçalho: Content-Type: xml/text
Clique em Body, selecione raw, em seguida, insira o conteúdo XML no corpo da mensagem. Um formato de exemplo é mostrado abaixo.
A estrutura é a seguinte:
Este é o cabeçalho de declaração XML e é obrigatório em cada solicitação.
Isso define a estrutura do comando XML. O atributo cmd pode ser get para recuperar os parâmetros atuais ou set para escrever novos parâmetros.
Isso especifica o item de configuração real. Neste exemplo, a solicitação recupera os parâmetros relacionados à linha SIP do dispositivo.
No uso real, a seção a seguir deve ser ajustada de acordo com o parâmetro real que você deseja consultar ou configurar:
Diferentes modelos podem suportar diferentes parâmetros da API HTTP. Você pode usar qualquer um dos seguintes métodos para obter a lista de parâmetros suportados para um dispositivo específico.
Método 1: Na interface WEB do dispositivo, vá para System – System Configuration, em seguida, exporte o arquivo de configuração do tipo nc.
Você pode clicar com o botão direito para salvar o arquivo, ou clicar com o botão esquerdo para visualizar a configuração diretamente. Os parâmetros comuns estão listados na próxima seção.
Método 2: Alguns modelos não fornecem o link do arquivo de configuração nc diretamente na interface web. Nesse caso, você pode inserir a URL correspondente na barra de endereços do navegador para recuperar o arquivo de configuração nc manualmente.
Nota: Este método pode demorar mais para responder.
Esta seção lista vários parâmetros comuns para referência. Mais parâmetros podem ser adicionados em futuras atualizações.
Exemplo de parâmetros de linha SIP (do dispositivo de controle de acesso i30):
sip.line.1.PhoneNumber = 112
sip.line.1.DisplayName = 112
sip.line.1.SipName =
sip.line.1.RegAddr = 172.18.1.45
sip.line.1.RegPort = 2066
sip.line.1.RegUser = 112
sip.line.1.RegPswd = abc123
sip.line.1.RegTTL = 3600
sip.line.1.RegEnabled = 0
sip.line.1. indica que esses parâmetros pertencem à linha SIP 1.
PhoneNumber corresponde ao campo de número de telefone na interface web.
DisplayName corresponde ao nome de exibição.
RegAddr é o endereço do servidor proxy SIP.
RegPort é a porta do servidor proxy SIP.
RegUser é o nome de usuário de autenticação, geralmente o mesmo que o número de telefone.
RegPswd é a senha.
RegTTL é o tempo de expiração do registro, com valor padrão de 3600 segundos.
RegEnabled define se a linha está habilitada: 0 significa desabilitada, 1 significa habilitada.
Exemplo de parâmetros da tecla DSS para o i30:
Recomenda-se configurar primeiro a tecla DSS na interface web, em seguida, usar a API HTTP com o comando get para ler os valores dos parâmetros correspondentes e confirmar o mapeamento exato.
Type=1 indica que o tipo de tecla DSS é Hotkey para dispositivos como o i30 ou i12. Para outros modelos, verifique o valor real do tipo usando o método recomendado acima.
Value=125@1/f significa:
125 = número de destino
@1 = linha 1
/f = subtipo: discagem rápida
Exemplo de parâmetros de rede para dispositivos como o i30 e i12:
WANMode indica o modo de rede, que pode ser DHCP ou static. Este parâmetro não pode ser escrito diretamente com o comando set. Ele muda automaticamente de acordo com o valor de dhcp.Enabled.
static.IP é o endereço IP estático. É efetivo apenas quando o dispositivo está no modo estático. No modo DHCP, o comando get ainda pode ser usado para recuperar o endereço IP atual.
static.SubnetMask é a máscara de sub-rede.
static.Gateway é o gateway padrão.
static.PrimaryDNS é o servidor DNS primário.
static.SecondaryDNS é o servidor DNS secundário.
dhcp.Enabled define se o DHCP está habilitado: 1 significa que o modo DHCP está ativo, enquanto 0 significa que o modo de IP estático está sendo usado.
Exemplo de parâmetros de volume para o BHP-SOS11V:
phone.volume.HandFreeVol é o volume do viva-voz. A faixa é 1-9, onde 9 é o volume mais alto.
phone.volume.HandFreeRingVol é o volume do toque para chamadas recebidas. A faixa é 1-9, onde 9 é o volume mais alto.
phone.volume.HandFreeToneVol é o volume dos tons de alerta, como alarmes e sons de notificação. A faixa é 1-9, onde 9 é o volume mais alto.
Os parâmetros de informações do sistema são somente leitura, o que significa que só podem ser consultados com o comando get.
Exemplo:
Este parâmetro retorna todas as informações do sistema. Se você precisar apenas de um item específico, estenda o caminho do parâmetro para o próximo nível de nó.
Por exemplo, para obter o endereço MAC do dispositivo:
