[ API ] Obter o Cadastro de um Assinante

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

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