Obter o Cadastro de um Cliente
Endereço de Chamada da API
/api/manageCustomers/API_TOKEN/API_KEY/id_cliente
Este Ponto de Acesso irá fornecer o Cadastro Completo de um Cliente. Se estiver utilizando Tokens de Acesso do Nível Master ou Nível Revenda, você deverá especificar o ID DO CLIENTE como último parâmetro da URL. Caso essa API seja chamada utilizando os Tokens de Acesso do Nível Assinante, não é necessário informar o ID e será retornado o Cadastro do Assinante em questão.
Para nosso exemplo, iremos deduzir que o endereço do servidor será sip.nextbilling.com.br. Nesse caso, o endereço da API seria:
Endereço da API exemplo
https://sip.nextbilling.com.br/api/manageCustomers/API_TOKEN/API_KEY/id_cliente
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:
Exemplo de chamada a API utilizando cURL
$ curl -X GET 'https://sip.nextbilling.com.br/api/manageCustomers/3'
Utilizando essa chamada, você obteria o retorno em JSON semelhante a saída a seguir:
Retorno JSON
{
"error":0,
"reason":"OK",
"records":1,
"data":[
{
"id":"3",
"tipo":"4",
"id_hie":"2",
"id_origem":"1",
"id_vinculo":"1",
"id_vendedor":"1",
"data_criacao":"2017-12-19",
"data_alteracao":"2018-02-06 15:41:27",
"nome_fantasia":"NEXTBILLING",
"razao_social":"NEXTBILLING IP SOLUTIONS",
"cpf":"21780980000162",
"rg":"isento",
"dominio":"127.0.0.1",
"website":"www.nextbilling.com.br",
"cep":"28990000",
"endereco":"rod. amaral peixoto",
"complemento":"51",
"bairro":"Centro",
"cidade":"Saquarema",
"uf":"RJ",
"pais":"Brasil",
"telefone":"2130900017",
"ramal":"",
"telefone2":"",
"celular":"",
"fax":"",
"celular_sms":"",
"notificar_sms":"0",
"contato":"Rafel",
"email":"rafarodriguesrj@yahoo.com.br",
"email_st":"0",
"email2":"",
"email2_st":"0",
"email_financeiro":"",
"email_financeiro_st":"0",
"tem_ramal":"1",
"tem_did":"1",
"tem_sms":"1",
"tem_escuta":"0",
"tem_gravacao":"1",
"tem_sigame":"1",
"tem_fila":"1",
"tem_ura":"1",
"tem_portal":"1",
"tem_callingcard":"1",
"tem_grupo_captura":"1",
"tem_grupo_chamada":"1",
"tem_campanha_sms":"1",
"tem_campanha_voz":"1",
"tem_conferencia":"1",
"tem_provisionamento":"1",
"moeda":"1",
"country_code":"55",
"tipo_loja":"0",
"tem_report":"0",
"status":"1",
"finance":{
"tipo_tar":"0",
"id_plano":"2",
"id_plano_sms":"0",
"habilita_npn":"0",
"habilita_npn_fixo":"0",
"saldo":"27.30000",
"limite_credito":"0.00",
"dia_vencimento":"1",
"dias_bloqueio":"10",
"status_bloqueio":"0",
"alerta_status":"0",
"alerta_valor":"0.00",
"simultaneas":"5",
"ini_f":"30",
"inc_f":"6",
"tmp_f":"0",
"ini_c":"30",
"inc_c":"6",
"tmp_c":"0",
"ini_f_ddi":"30",
"inc_f_ddi":"6",
"tmp_f_ddi":"0",
"ini_c_ddi":"30",
"inc_c_ddi":"6",
"tmp_c_ddi":"0",
"allow_loss_call":"0",
"id_perfil":"1",
"sipcode_no_prefix":"503",
"franquia_fixo_local":"0",
"franquia_fixo_ldn":"0",
"franquia_movel_local":"0",
"franquia_movel_ldn":"0",
"franquia_fixo_ddi":"0",
"franquia_movel_ddi":"0",
"franquia_fixo_local_used":"30",
"franquia_fixo_ldn_used":"84",
"franquia_movel_local_used":"30",
"franquia_movel_ldn_used":"30",
"franquia_fixo_ddi_used":"0",
"franquia_movel_ddi_used":"0",
"franquia_last_reset":"0000-00-00 00:00:00",
"disk_space":"30048",
"available_disk_space":"25704",
"call_only_local":"1",
"max_devices":"0"
},
"users":[
{
"id":"5",
"id_perfil":"3",
"username":"assinantenext",
"nome_completo":"Rafel",
"email":"rafarodriguesrj@yahoo.com.br",
"celular":"",
"root":"1",
"logins":"18",
"last_login":"0",
"last_attempt":"0",
"failed_attempts":"0",
"api_access":"0",
"can_spy":"0",
"api_token":"awe4w0q-6qw5e4-qw65e40-as65e04",
"api_key":"asdeqwe-asdqwe-a2w140e-aw5se40",
"status":"1"
}
]
}
]
}
Campo |
Descrição |
||
error |
1 em caso de erro |
||
reason |
Descrição caso tenha ocorrido algum erro |
||
id |
id do Cliente |
||
tipo |
2 - Revenda |
4 - Assinante |
|
id_hie |
ID da Revenda |
||
id_origem |
ID do Tipo de Origem |
||
id_vinculo |
ID do Vinculo de Cliente |
||
id_vendedor |
ID do Vendendor |
||
tem_ramal |
Acesso a Ramais: 0 - Inativo |
1 - Ativo |
|
tem_did |
Acesso a DID: 0 - Inativo |
1 - Ativo |
|
tem_sms |
Acesso a SMS: 0 - Inativo |
1 - Ativo |
|
tem_escuta |
Tem Escuta de Chamadas: 0 - Inativo |
1 - Ativo |
|
tem_gravacao |
Pode Gravar Chamadas: 0 - Inativo |
1 - Ativo |
|
tem_sigame |
Acesso a Siga-ME: 0 - Inativo |
1 - Ativo |
|
tem_fila |
Acesso a Filas de Atendimento: 0 - Inativo |
1 - Ativo |
|
tem_ura |
Acesso a URA: 0 - Inativo |
1 - Ativo |
|
tem_portal |
Acesso a Portal de Voz: 0 - Inativo |
1 - Ativo |
|
tem_callingcard |
Acesso a CallingCards: 0 - Inativo |
1 - Ativo |
|
tem_grupo_captura |
Acesso a Grupos de Captura: 0 - Inativo |
1 - Ativo |
|
tem_grupo_chamada |
Acesso a Grupos de Chamada: 0 - Inativo |
1 - Ativo |
|
tem_campanha_sms |
Acesso a Campanhas de SMS: 0 - Inativo |
1 - Ativo |
|
tem_campanha_voz |
Acesso a Campanhas de Voz: 0 - Inativo |
1 - Ativo |
|
tem_conferencia |
Acesso a Salas de Conferência: 0 - Inativo |
1 - Ativo |
|
tem_provisionamento |
Acesso a Provisionamento: 0 - Inativo |
1 - Ativo |
|
tem_report |
Flag utilizada internamente pelo Sistema |
||
status |
Status do Cliente: 0 - Inativo |
1 - Ativo |
|
finance.tipo_tar |
Tipo Financeiro: 0 - PRE-PAGO |
1 - PÓS-PAGO |
2 - FRANQUIA |
finance.id_plano |
ID do Plano de Prefixos |
||
finance.id_plano_sms |
ID do Plano de SMS |
||
finance.habilita_npn |
Permite Consulta a Portabilidade Móvel |
||
finance.habilita_npn_fixo |
Permite Consulta a Portabilidade Fixo |
||
finance.ini_f |
Tarifação Fixo Inicial |
||
finance.inc_f |
Incremento Fixo |
||
finance.tmp_f |
Tolerância Fixo |
||
finance.ini_c |
Tarifação Móvel Inicial |
||
finance.inc_c |
Incremento Móvel |
||
finance.tmp_c |
Tolerância Móvel |
||
finance.ini_f_ddi |
Tarifação Fixo DDI Inicial |
||
finance.inc_f_ddi |
Incremento Fixo DDI |
||
finance.tmp_f_ddi |
Tolerância Fixo DDI |
||
finance.ini_c_ddi |
Tarifação Móvel DDI Inicial |
||
finance.inc_c_ddi |
Incremento Móvel DDI |
||
finance.tmp_c_ddi |
Tolerância Móvel DDI |
||
finance.allow_loss_call |
Permitir Preço de Venda menor do que o Custo |
0 - Não |
1 - Sim |
finance.id_perfil |
ID do Perfil Financeiro |
||
finance.sipcode_no_prefix |
SIP Code em caso de prefixo não existe |
||
finance.franquia_fixo_local |
ID da Franquia Fixo Local |
||
finance.franquia_fixo_ldn |
ID da Franquia Fixo Longa Distância |
||
finance.franquia_movel_local |
ID da Franquia Móvel Local |
||
finance.franquia_movel_ldn |
ID da Franquia Móvel Longa Distância |
||
finance.franquia_fixo_ddi |
ID da Franquia Fixo DDI |
||
finance.franquia_movel_ddi |
ID da Franquia Móvel DDI |
||
finance.franquia_fixo_local_used |
Minutos Utilizados na Franquia Fixo Local |
||
finance.franquia_fixo_ldn_used |
Minutos Utilizados na Franquia Fixo Longa Distância |
||
finance.franquia_movel_local_used |
Minutos Utilizados na Franquia Móvel Local |
||
finance.franquia_movel_ldn_used |
Minutos Utilizados na Franquia Móvel Longa Distância |
||
finance.franquia_fixo_ddi_used |
Minutos Utilizados na Franquia Fixo DDI |
||
finance.franquia_movel_ddi_used |
Minutos Utilizados na Franquia Móvel DDI |
||
finance.franquia_last_reset |
Inicio do Ciclo da Franquia |
||
finance.disk_space |
Espaço em disco contratado (em MB) |
0 - Ilimitado |
|
finance.available_disk_space |
Espaço em disco disponível para o Cliente |
||
finance.call_only_local |
Permitir IPxIP apenas para Linhas do Cliente |
1 - Sim |
0 - Global |
finance.max_devices |
Máximo de Linhas que o Cliente pode criar |
0 - Ilimitado |
|
users.id |
ID do Usuário |
||
users.id_perfil |
ID do Perfil de Acesso |
||
users.username |
Usuário de Acesso |
||
users.nome_completo |
Nome Completo do Usuário |
||
users.root |
1 - Usuário Principal |
0 - Usuário Adicional |
|
users.logins |
Quantidade de Acessos ao Painel |
||
users.last_login |
Último acesso ao Painel (unix timestamp) |
||
users.last_attempt |
Último acesso com senha inválida (unix timestamp) |
||
users.failed_attempts |
Quantidade de Tentativas de Acesso com senha inválida |
||
users.api_access |
Tem acesso a API? 0 - Não |
1 - Sim |
|
users.can_spy |
Pode realizar escuta de ligações? 0 - Não |
1 - Sim |
|
users.api_token |
API TOKEN para acesso a API |
||
users.api_key |
API KEY para acesso a API |
||
users.status |
Status atual do usuário |