Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.


...

Tip
titleEndereço de Chamada da API

/api/manageDevices/API_TOKEN/API_KEY/id_linha

...



Este Ponto de Acesso irá fornecer o Cadastro Completo de uma Linha IP.
Você deverá especificar o ID DA LINHA IP como último parâmetro da URL.

Para nosso exemplo, iremos deduzir que o endereço do servidor será sip.nextbilling.com.br. Nesse caso, o endereço da API seria:

Info
titleEndereço da API exemplo

https://sip.nextbilling.com.br/api/manageDevices/API_TOKEN/API_KEY/id_linha

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:

Panel
titleExemplo de chamada a API utilizando cURL
$ curl -X GET 'https://sip.nextbilling.com.br/api/manageDevices/3'

Utilizando essa chamada, você obteria o retorno em JSON semelhante a saída a seguir:

Code Block
languagegroovy
themeMidnight
titleRetorno JSON
{

...


   "error":0,

...


   "reason":"OK",

...


   "records":1,

...


   "data":[

...


      {
         "id":"3",

...


         "id_cliente":"3",

...


         "id_plano":"0",

...


         "id_audio":"0",

...


         "id_perfil_horario":"0",

...


         "tipo_tar":"1",

...


         "ddd_local":"5521",

...


         "tech":"SIP",

...


         "username":"rafael9002",

...


         "password":"mPoxEsgV1d",

...


         "domain":"dynamic",

...


         "port":"0",

...


         "rtp_symmetric":"1",

...


         "nat":"auto_force_rport,auto_comedia",

...


         "techprefix":"",

...


         "saldo":"0.00000",

...


         "voip":"1",

...


         "fixo_local":"1",

...


         "fixo_ldn":"1",

...


         "movel_local":"1",

...


         "movel_ldn":"1",

...


         "fixo_ddi":"0",

...


         "movel_ddi":"0",

...


         "simultaneas":"0",

...


         "allow_transfer":"1",

...


         "allow_video":"1",

...


         "allow_record_fixo":"1",

...


         "allow_record_movel":"1",

...


         "allow_spy":"0",

...


         "reproduzir_erros":"1",

...


         "voicemail_status":"0",

...


         "voicemail_password":"",

...


         "cadeado_status":"0",

...


         "cadeado_password":"",

...


         "portal_password":"99966123",

...


         "ring_falso":"0",

...


         "max_calltime":"7200",

...


         "max_ringtime":"45",

...


         "max_ringtime_voip":"30",

...


         "codecs":"g729;ulaw;alaw",

...


         "is_webrtc":"0",

...


         "sigame_always_st":"0",

...


         "sigame_always_dst":"021985699899",

...


         "sigame_busy_st":"0",

...


         "sigame_busy_dst":"",

...


         "sigame_noanswer_st":"0",

...


         "sigame_noanswer_dst":"",

...


         "sigame_offline_st":"0",

...


         "sigame_offline_dst":"",

...


         "callerid_name":"",

...


         "callerid_num":"",

...


         "linha_ip":"9002",

...


         "dtmf_mode":"rfc4733",

...


         "volume_tx":"-21",

...


         "volume_rx":"-21",

...


         "funcionalidade":"0",

...


         "funcionalidade_id":"0",

...


         "habilita_npn_fixo":"0",

...


         "habilita_npn_movel":"0",

...


         "status":"1"

...


      }
   ]
}


Campo
Descrição
error1 em caso de erro
reasonDescrição caso tenha ocorrido algum erro
recordsTotal de registrados retornados nessa chamada
id_clienteID do Cliente
nome_fantasiaNome do Cliente
recordsQuantidade de Linhas para esse Cliente
dataArray contendo as Linhas solicitadas
idID da Linha
id_planoID do Plano de Prefixos Customizado
id_audioID do Audio a ser reproduzido antes de cada Ligação
id_perfil_horarioID do Perfil de Horário da Linha
tipo_tarTipo de Tarifação: 0 - SALDO DA LINHA
| 1 - SALDO DO CLIENTE
ddd_localDDD Local da Linha
techTecnologia utilizada pela Linha (Ex: DAHDI, SIP, DGV)
usernameNome de Usuário da Linha
passwordSenha da Linha
domainEndereço IP da Linha
portPorta de Conexão da Linha
rtp_symmetricAtivar RTP Simétrico: 0 - desativado
| 1 - ativado
natTipo de NAT utilizado pela Linha
techprefixTechprefix da Linha caso a mesma seja por IP + TECHPREFIX
saldoSaldo atual da Linha, se tipo_tar = 0
voipPermitir chamadas IP x IP: 0 - desativado
| 1 - ativado
fixo_localPermitir chamadas Fixo Local
fixo_ldnPermitir chamadas Fixo Longa Distância
movel_localPermitir chamadas Móvel Local
movel_ldnPermitir chamadas Móvel Longa Distância
fixo_ddiPermitir chamadas Fixo DDI
movel_ddiPermitir chamadas Móvel DDI
simultaneasChamadas simultâneas permitidas pela Linha
allow_transferPermitir Transferência
allow_record_fixoGravar chamadas para Fixo
allow_record_movelGravar chamadas para Móvel
allow_spyPermitir que essa Linha realize escuta
reproduzir_errosReproduzir erros na Linha
voicemail_statusStatus do Correio de Voz: 0 - inativo
| 1 - ativo
voicemail_passwordSenha do Correio de Voz
cadeado_statusStatus do Cadeado
cadeado_passwordSenha do Cadeado
portal_passwordSenha do Portal de Voz
ring_falsoReproduzir Ring Falso
max_calltimeTempo máximo em uma ligação
max_ringtimeTempo máximo chamando antes de considerar NÃO ATENDIDO
max_ringtime_voipTempo máximo que essa linha irá ser chamada
codecsCodecs habilitados para a Linha
sigame_always_stEstado do Siga-ME Sempre
sigame_always_dstDestino do Siga-ME Sempre
sigame_busy_stEstado do Siga-ME Ocupado
sigame_busy_dstDestino do Siga-ME Ocupado 
sigame_noanswer_stEstado do Siga-ME Não Atende 
sigame_noasnwer_dstDestino do Siga-ME Não Atende 
sigame_offline_stEstado do Siga-ME OFFLINE 
sigame_offline_dstDestino do Siga-ME OFFLINE 
callerid_name Nome a ser exibido em Ligações Internas
callerid_numNúmero a ser exibido em Ligações Externas 
linha_ipNúmero da Linha IP / RAMAL 
dtmf_modeModo de DTMF 
volume_txVolume de Transmissão de áudio 
volume_rxVolume de Recepção de áudio 
funcionalidade

Tipo de Funcionalidade da Linha:

  • 0 - LINHA IP / RAMAL
  • 1 - PORTAL DE VOZ
  • 2 - CENTRAL CALLINGCARD
  • 3 - MENU DE URA - IVR
  • 4 - FILA DE ATENDIMENTO
  • 5 - CABINE TELEFÔNICA
funcionalidade_idID de Registro de Funcionalidade da Linha, quando aplicável 
statusStatus atual da Linha IP