Este Ponto de Acesso irá fornecer o Saldo de uma Linha IP. Alguns equipamentos e softphones tem a opção de utilizar uma API para consultar e exibir o Saldo de uma ou mais Linhas no visor do Equipamento.
Para utilizar essa API, você deverá informar o em API_TOKEN o Login/Usuário da Linha, e o parâmetro API_KEY deverá ser formado pela função MD5(USUÁRIO_DA_LINHA:SENHA_DA_LINHA).
Um exemplo seria:
Usuário: linhaip1
Senha: Senha#Da#Linha.IP1
Baseado nos dados acima, teríamos a seguinte URL de chamada para a API:
API_TOKEN: linhaip1
Função MD5(linhaip1:Senha#Da#Linha.IP1) = f9f0115a96fcdc8146188f96fc96f96b
API_KEY: f9f0115a96fcdc8146188f96fc96f96b
URL Final: /api/getDeviceBalance/linhaip1/f9f0115a96fcdc8146188f96fc96f96b
Para nosso exemplo, iremos deduzir que o endereço do servidor será api.voipmundotelecom.com.br. Nesse caso, o endereço da API seria:
A chamada para obter os dados da consulta, é realizado utilizando um HTTP GET para o endereço de consumo da API. Um exemplo de chamada a essa API seria:
Utilizando essa chamada, você obteria o retorno em JSON semelhante a saída a seguir:
Bem, não exatamente... Ao final do primeiro ano da faculdade, eu estava fascinado com computadores…
600 Busy Everywhere Todos os destinos possíveis estão ocupados. 603 Decline O destino nao deseja…
500 Server Internal Error O servidor nao pôde completar o pedido por causa de uma…
400 Bad Request A solicitação não pode ser compreendida devido a uma sintaxe errada. […
300 Multiple Choices O endereço / IP / Chamada foi redirecionado a varias opções para…
200 OK Indica que a solicitação foi completada com sucesso. 202 Accepted Indica que a…