Autenticação
Requisição do tipo
POST
com o corpo json
{
"username": "{usuario}",
"password": "{senha}"
}
Exemplo autenticação
{urlApplication}/auth/generatetoken
Body:
{
"username": "usuario",
"password": "senha"
}
A resposta será um token que deverá ser colocado com a chave
Authorization
no cabeçalho de cada requisição dos outros serviços:
Digicade-Rest-API:{token}
Revalidação do token
O token inicial possui uma validade de 30 minutos depois de gerado. Na autenticação
um refreshToken é enviado juntamente com o token inicial para que este possa
ser revalidado. Para gerar um novo token deve-se enviar a requisição abaixo, do tipo POST
,
colocando a chave
Authorization
no cabeçalho e como valor Digicade-Rest-API:{refreshToken}
. O token de revalidação possui uma validade de 30 dias.
Após o token expirar, é necessário realizar a autenticação novamente.
{urlApplication}/auth/refresh
Feições
Feição | Path |
---|---|
Cliente | cliente |
Caixa de Emenda | caixaEmenda |
CTO | cto |
CAH | cah |
Estação | estacao |
HUB | hub |
Lance de Cabo | lanceCabo |
Poste | poste |
Splitter | splitter |
Terminador Óptico | terminadorOptico |
Serviços
- desc
Obtém a lista de colunas da feição. Requisição do tipo
GET
. No retorno da requisição, as colunas estão no atributo columns
e a descrição é dada pela chave alias
Exemplo requisição:
{urlApplication}/{feicao}/desc
- get
Obtém registro único de acordo com o fid. Requisição do tipo
GET
com o único e obrigatório parâmetro fid :
Exemplo requisição:
{urlApplication}/{feicao}/get?fid={fid}
- list
Obtém lista de registro das feições. Requisição do tipo
GET
.
Parâmetros:
limit: quantidade de registros que a requisição deve retornar
columns: parâmetro obrigatório. Indica quais colunas da feição a requisição deve retornar. Devem ser separadas por vírgulas.
filter: Filtro com base nas colunas em linguagem SQL
sorter: Ordenação de acordo com colunas. Separadas por vírgulas
Exemplo requisição:
{urlApplication}/poste/list?columns=fid,numero,altura&limit=10&sorter=numero&filter=altura > 12
O exemplo acima retorna a lista com o fid, o número e a altura de 10 postes com mais de 12 metros, ordenados pelo número.
- count
Obtém a quantidade de registros da feição. Requisição do tipo
GET
. Possui o parâmetro filter opcional onde pode ser passado
um filtro de acordo com a coluna em linguagem SQL.
Exemplo requisição:
{urlApplication}/poste/count?filter=altura=10
- delete
Deleta o registro da feição de acordo com o fid. Requisição do
tipo
POST
com o único e obrigatório parâmetro fid :
Exemplo requisição:
{urlApplication}/{feicao}/delete?fid={fid}
- save
Insere o registro da feição. Requisição do tipo
POST
. Os dados a serem salvos devem ser passados no corpo da
requisição em um objeto do tipo
application/json
.
Exemplo requisição:
{urlApplication}/{feicao}/save
- Atributos save Cliente:
fid: Quando não nulo deve ser o fid de um cliente já existente para edição.codigo: Quando não nulo deve ser único.
nome*
documento
contrato
latitude: parâmetro do tipo double.
longitude: parâmetro do tipo double.
endereco: Na ausência de latitude e longitude é obrigatório.
numeroPorta: parâmetro do tipo inteiro.
complementoEndereco
telefone
fidTipo*: 1 se é cliente residencial, 2 se é comercial.
indDedicado: 1 se é cliente dedicado.
fidFluxoAtendimento*: 1 se é cliente prospectado; 2 interessado; 3 viabilidade técnica; 4 atendimento reservado; 5 ativo; 6 inativo; 7 aguardando ativação; 8 desligado; 9 ativo sem rede.
macOnu
codigoOnu
qtdPortasAtendimento: parâmetro do tipo inteiro e maior que 0.
sinal: parâmetro do tipo double.
comprimentoFibra: parâmetro do tipo double.
infoComplementar
codigoCaixa: parâmetro opcional usado quando deseja-se inserir cliente em uma caixa.
fidTipoCaixa: parâmetro deve ser usado juntamente com codigoCaixa. 1 se Caixa de Emenda; 2 se CTO; 3 se Terminador Óptico; 4 se CAH; e 5 se Hub.
fidCaixa: parâmetro alternativo ao uso de codigoCaixa e fidTipoCaixa. Em vez de informar o código da caixa e seu tipo pode-se apenas informar seu fid para inserir o cliente.
- Atributos save Caixa Emenda/CTO/Terminador Óptico/CAH/HUB:
fid: Quando não nulo deve ser o fid de uma caixa já existente para edição.codigo*
latitude: parâmetro do tipo double.
longitude: parâmetro do tipo double.
endereco: Na ausência de latitude e longitude é obrigatório.
fidModelo*: parâmetro do tipo inteiro.
fidFabricante*: parâmetro do tipo inteiro.
fidTipoUtilizacaoMaterial*: 1 se é área; 2 subterrânea.
numeroMaxDerivacao: parâmetro do tipo inteiro.
capacidadeBandejas: parâmetro do tipo inteiro.
capacidadeFibrasBandeja*: parâmetro do tipo inteiro.
sangria: 1 se é sangria.
infoComplementar
A requisição abaixo pode ser utilizada para obter modelos de Caixas de Emenda, CTO, Terminador Óptico, CAH e HUB. Para Caixas de Emenda deve-se passar o filtro fidTipoCaixaEmenda=1; para CTO, fidTipoCaixaEmenda=2; para Terminador Óptico, fidTipoCaixaEmenda=3; para CAH, fidTipoCaixaEmenda=4;e para HUB, fidTipoCaixaEmenda=5;:
{urlApplication}/modeloCaixa/list?columns=fid,descricao&filter=fidTipoCaixaEmenda={tipo}
A requisição abaixo pode ser utilizada para obter fabricantes de Caixas de Emenda, CTO,
Terminador Óptico, CAH e HUB:
{urlApplication}/fabricanteCaixa/list?columns=fid,descricao
- Atributos save Poste:
fid: Quando não nulo deve ser o fid de um poste já existente para edição.numero: Quando não nulo deve ser único.
altura: parâmetro do tipo double;
carga: parâmetro do tipo double;
latitude*: parâmetro do tipo double.
longitude*: parâmetro do tipo double.
dataInstalacao: formato dd/mm/aaaa.
fidPropriedade*: parâmetro do tipo inteiro.
fidTerceiro: parâmetro do tipo inteiro.
fidTipoMaterial*: parâmetro do tipo inteiro. 1 se madeira; 2 se concreto; 3 se ferro.
fidTipoSecao*: parâmetro do tipo inteiro.
indChaveFaca: 1 se possui chave faca
indDescida: 1 se possui descida força
indTransformador: 1 se possui transformador
indVinculacao: 1 se possui vinculação
infoComplementar
A requisição abaixo pode ser utilizada para obter os tipos de propriedades de postes:
{urlApplication}/propriedadePoste/list?columns=fid,descricao,indTerceiroObrigatorio
A requisição abaixo pode ser utilizada para obter os tipos de terceiros de postes:
{urlApplication}/terceiroPoste/list?columns=fid,nome
A requisição abaixo pode ser utilizada para obter os tipos de seções de poste:
{urlApplication}/secaoPoste/list?columns=fid,descricao
A requisição abaixo pode ser utilizada para obter os tipos de materiais de poste:
{urlApplication}/materialPoste/list?columns=fid,descricao
- Operações com Clientes em Caixas
Os serviços disponíveis para manipular clientes em Caixas (Caixa de Emenda, CTO, Terminador Óptico,CAH e HUB) são: adicionar Cliente (na Caixa); adicionar Conexão (caso o cliente já esteja inserido na Caixa); remover Cliente e sua conexão (se houver); remover apenas a conexão do Cliente; reservar Porta (destinar uma porta de Splitter para um Cliente específico) e atualizar Reserva (atualizar a o status da Conexão de reservada para ativa).
Atributos para operações em Caixas:
fidCliente: Fid do Cliente a ser inserido na caixa.codigoCaixa*: código da caixa que deseja-se inserir o cliente.
fidTipoCaixa*: parâmetro deve ser usado juntamente com codigoCaixa. 1 se Caixa de Emenda; 2 se CTO; 3 se Terminador Óptico; 4 se CAH; e 5 se HUB.
fidCaixa*: parâmetro alternativo ao uso de codigoCaixa e fidTipoCaixa. Em vez de informar o código da caixa e seu tipo pode-se apenas informar seu fid para inserir o cliente.
codigoSplitter: parâmetro opcional usado quando deseja-se conectar o cliente em um splitter.
fidSplitter: parâmetro alternativo ao uso de codigoSplitter. Em vez de informar o código do splitter pode-se apenas informar seu fid para conectar o cliente.
numeroPortaCliente: número da porta do Cliente que deseja-se conectar o Splitter. A porta do Cliente não deve estar ocupada. Caso não informado o sistema identifica o valor padrão como porta 0.
numeroPortaSplitter: número da porta do Splitter que deseja-se conectar o Cliente. Parâmetro obrigatório quando se informa o códido do Splitter ou o fid do Splitter. A porta do Splitter não deve estar ocupada.
* codigoCaixa e fidTipoCaixa são obrigatórios na ausência de fidCaixa
- Adicionar Cliente:
Requisição do tipo
POST
. Os dados a serem salvos devem ser passados no corpo da
requisição em um objeto do tipo
application/json
.
Atributos obrigatórios: fidCliente; fidCaixa ou codigoCaixa e fidTipoCaixa
Atributos opcionais: fidSplitter ou codigoSplitter; numeroPortaSplitter;numeroPortaCliente
Se os parâmetros opcionais não forem passados, o Cliente é adicionado na Caixa, mas sem a criação de uma Conexão.
Caso os parametros relacionados a criação da conexão seja passado e o numero da porta do Cliente não, a conexão será realizada na porta 0 do cliente.
Requisição:
{urlApplication}/fusoesCaixa/inserirCliente
- Adicionar Conexão:
Requisição do tipo
POST
. Os dados a serem salvos devem ser passados no corpo da
requisição em um objeto do tipo
application/json
.
Atributos obrigatórios: fidCliente
Atributos opcionais: fidSplitter ou codigoSplitter; numeroPortaSplitter; numeroPortaCliente
Se os parâmetros relacionados ao Splitter não forem passados, a Conexão é criada automaticamente na primeira porta de Splitter de atendimento disponível. Se o numero da porta do Cliente não for passado, a conexão será criada na porta 0 do cliente.
Requisição:
{urlApplication}/fusoesCaixa/adicionarConexao
- Remover Cliente:
Requisição do tipo
POST
. O Fid do Cliente deve ser passado como parâmetro na URL da requisição.
Requisição:
{urlApplication}/fusoesCaixa/removerCliente?fidCliente={fidCliente}
- Remover Conexão do Cliente:
Requisição do tipo
POST
. O Fid do Cliente deve ser passado como parâmetro na URL da requisição.
Requisição:
{urlApplication}/fusoesCaixa/removerConexaoCliente?fidCliente={fidCliente}
- Reservar Porta:
Requisição do tipo
POST
. Os dados a serem salvos devem ser passados no corpo da
requisição em um objeto do tipo
application/json
.
Atributos obrigatórios: fidCliente; fidCaixa
Atributos opcionais: fidSplitter; numeroPortaSplitter
Se os parâmetros opcionais não forem passados, a Reserva é efetuada automaticamente na primeira porta de Splitter de atendimento disponível.
Requisição:
{urlApplication}/fusoesCaixa/reservarPorta
Resposta:
porta: número da porta em que a reserva foi feita
fidSplitter: identificação do splitter
fidConexão: identificação da conexão criada
dataExpiracao: data (no formato 'dd/MM/aaaa HH:mm:ss') em que a reserva expira
- Update da Reserva:
Requisição do tipo
POST
. Os Fid's do Cliente e da Caixa devem ser passados como parâmetro na URL da requisição.
Requisição:
{urlApplication}/fusoesCaixa/updateReserva?fidCliente={fidCliente}&fidCaixa={fidCaixa}
- Listar notas:
Requisição do tipo
GET
. O fid do tipo de feição e o fid da caixa devem ser passados na URL da requisição.
Requisição:
{urlApplication}/nota/list?columns=fid,texto&limit=10&sorter=texto&filter=fidTipoFeicaoEsquematico=87%AND%fidFeicaoEsquematico={fidCaixa}
- Listar clientes conectados ao splitter:
Requisição do tipo
GET
. O tipo de splitter: 1 – Atendimento e 2 – Distribuição e o status da conexão: 0 - sem reserva e 1 - reservado devem ser informados.
Requisição:
{urlApplication}/splitterCliente/list?columns=nome&limit=10&sorter=nome&filter=tipoSplitter=1%AND%reservado=1%AND%fidSplitter={fidSplitter}
- Operações com Splitter
O serviço disponível para manipular splitter funciona como cadastro e edição.
Atributos para operações em Splitter:
fid: Quando não nulo deve ser o fid de uma caixa já existente para edição.fidModeloSplitter*: Fid do modelo do splitter, conforme tabela de modelos de splitter.
codigo: Campo alfanumérico de até 30 caracteres.
indBalanceado*: 0 – Não balanceado e 1 – Balanceado. Se não informado, será inserido como 0.
indConectorizado*: 0 – Não conectorizado e 1 – Conectorizado. Se não informado, será inserido como 0.
fidTipoConector: Fid do tipo de conector óptico utilizado, conforme a tabela de tipos de conector.
numeroBandeja: Numerção da bandeja onde está instalado.
fidConexaoEstacao: Fid da conexão com a estação.
fidTipoFeicaoInstalacao*: Fid do tipo da feição onde o splitter está instalado: 87 - Caixa de emenda ou 38 – Estação.
fidFeicaoInstalacao*: Fid da feição onde o splitter está instalado.
perdaSinal: Valor alfanumérico de até 1000 caracteres.
fidPropriedade: Fid da propriedade, conforme tabela de propriedades.
fidTerceiro: Fid do terceiro cadastrado. Obrigatório caso o fidPropriedade for 2, 3 ou 4.
fidTipo*: 1 – Atendimento e 2 – Distribuição.
infoComplementar: Informações adicionais de até 1000 caracteres.
sinalMedidoSaida1: Valor número para indicar qual o sinal medido na saída 1.
sinalMedidoSaida2: Valor número para indicar qual o sinal medido na saída 2.
indPortasInvertidas*: 0 – Numeração de portas crescente e 1 – Numeração das portas invertidas ou decrescente. Se não informado, será inserido como 0.
* fidTerceiro é obrigatório caso fidPropriedade seja 2, 3 ou 4.
- Salvar ou alterar splitter:
Requisição do tipo
POST
. Os dados a serem salvos devem ser passados no corpo da
requisição em um objeto do tipo
application/json
.
Atributos obrigatórios: fidModeloSplitter, fidTipoFeicaoInstalacao, fidFeicaoInstalacao e fidTipo
Atributos opcionais: indBalanceado, indConectorizado e fidModeloSplitter
Se os parâmetros opcionais não forem informados, o valor no banco ficará como 0.
Requisição:
{urlApplication}/splitter/save
Tabelas:
Fid | Descrição | Qtd. portas de entrada | Qtd. portas de saída |
1 | PLC 2X4 | 2 | 4 |
2 | PLC 2X8 | 2 | 8 |
3 | PLC 2X16 | 2 | 16 |
4 | PLC 2X32 | 2 | 32 |
5 | PLC 1X4 | 1 | 4 |
6 | PLC 1X8 | 1 | 8 |
7 | PLC 1X16 | 1 | 16 |
8 | PLC 1X32 | 1 | 32 |
11 | PLC 1X64 | 1 | 64 |
12 | PLC 1X128 | 1 | 128 |
13 | PLC 2X2 | 2 | 2 |
14 | PLC 2X64 | 2 | 64 |
15 | FBT 1X2 | 1 | 2 |
16 | FBT 2X2 | 2 | 2 |
17 | FBT 1X2 - 1/99 | 1 | 2 |
18 | FBT 1X2 - 2/98 | 1 | 2 |
19 | FBT 1X2 - 5/95 | 1 | 2 |
20 | FBT 1X2 - 10/90 | 1 | 2 |
21 | FBT 1X2 - 15/85 | 1 | 2 |
22 | FBT 1X2 - 20/80 | 1 | 2 |
23 | FBT 1X2 - 25/75 | 1 | 2 |
24 | FBT 1X2 - 30/70 | 1 | 2 |
25 | FBT 1X2 - 35/65 | 1 | 2 |
26 | FBT 1X2 - 40/60 | 1 | 2 |
27 | FBT 1X2 - 45/55 | 1 | 2 |
28 | PLC 1X2 - 1/99 | 1 | 2 |
29 | PLC 1X2 - 2/98 | 1 | 2 |
30 | PLC 1X2 - 5/95 | 1 | 2 |
31 | PLC 1X2 - 10/90 | 1 | 2 |
32 | PLC 1X2 - 15/85 | 1 | 2 |
33 | PLC 1X2 - 20/80 | 1 | 2 |
34 | PLC 1X2 - 25/75 | 1 | 2 |
35 | PLC 1X2 - 30/70 | 1 | 2 |
36 | PLC 1X2 - 35/65 | 1 | 2 |
37 | PLC 1X2 - 40/60 | 1 | 2 |
38 | PLC 1X2 - 45/55 | 1 | 2 |
39 | PLC MODULAR 1X2 | 1 | 2 |
40 | PLC MODULAR 1X4 | 1 | 4 |
41 | PLC MODULAR 1X8 | 1 | 8 |
42 | PLC MODULAR 1X16 | 1 | 16 |
43 | PLC MODULAR 1X32 | 1 | 32 |
10 | PLC 1X2 | 1 | 2 |
44 | PLC 1X6 | 1 | 6 |
Fid | Descrição |
1 | OUTROS |
2 | FC/APC-SM |
3 | SC-UPC |
4 | SC/PC-MM-DUPLEX |
5 | FC/PC-MM |
6 | FC/PC-SM |
7 | ST/PC-MM |
8 | SC/PC-MM |
9 | SC/PC-SM |
10 | SC/APC-SM |
11 | E-200 APC |
12 | LC/APC-SM |
13 | LC/PC-MM |
14 | LC/PC-SM |
15 | LC/PC-MM-DUPLEX |
16 | LC/PC-SM-BOTA0.9mm |
17 | LC/PC-SM-DUPLEX |
18 | SC/PC-SM-DUPLEX |
Fid | Descrição | IndTeceiroObrigatorio |
0 | Não definido | 0 |
1 | Próprio | 0 |
2 | Alugado de terceiros | 1 |
3 | Alugado para terceiros | 1 |
4 | Terceiros | 1 |
Viabilidade Técnica
- Consulta de Caixas Splitter/FTTH:
Requisição do tipo
GET
. Os parâmetros devem ser passados na URL.
Atributos:
raio*: Atributo em metros do tipo double. Indica o raio da consulta de caixas a partir do endereço informado.endereco**
latitude**: deve ser informada em EPSG:4326.
longitude**: deve ser informada em EPSG:4326.
googlePlaceId**: Identificador de endereços do Google. Pode ser obtido realizando a consulta de endereços do serviço acima.
**Devem ser informados endereco ou googlePlaceId ou latitude e longitude.
Exemplo requisição:
{urlApplication}/viabilidade/caixas?raio=200&endereco=Rua tomé de souza, 845, funcionários, BH - MG
O retorno será uma lista de caixas que estão dentro raio com os seguintes atributos:
tipoCodigo: Atributo de descrição e tipo da caixa.distancia: Distância radial em metrod entre o ponto de análise de viabilidade e a caixa.
qtdTotalDisponivel: Quantidade total de portas disponíveis, resultado da soma de portas splitter e de ethernet.
qtdSplitter: Quantidade total de splitters dentro da caixa.
qtdPortasSplitter: Quantidade total de portas de splitters dentro da caixa.
qtdPortasSplitterDisp: Quantidade total de portas disponíveis de splitters dentro da caixa.
qtdPortasSplitterOcup: Quantidade total de portas ocupadas de splitters dentro da caixa.
qtdEquipamentosPacpon: Quantidade total de equipamentos ethernet dentro da caixa.
qtdPortasEthernet: Quantidade total de portas de equipamentos ethernet dentro da caixa.
qtdPortasEthernetDisp: Quantidade total de portas disponíveis de equipamentos ethernet dentro da caixa.
qtdPortasEthernetOcup: Quantidade total de portas ocupadas de equipamentos ethernet dentro da caixa.
- Consulta de Caixas com rotas sugeridas Splitter/FTTH:
Requisição do tipo
GET
. Os parâmetros devem ser passados na URL.
Atributos:
raio*: Atributo em metros do tipo double. Indica o raio da consulta de caixas a partir do endereço informado.endereco**
qtdRotas*: Atributo do tipo integer, menor ou igual a 5. Indica a quantidade máxima de rotas sugeridas.
latitude**: deve ser informada em EPSG:4326.
longitude**: deve ser informada em EPSG:4326.
googlePlaceId**: Identificador de endereços do Google. Pode ser obtido realizando a consulta de endereços do serviço acima.
**Devem ser informados endereco ou googlePlaceId ou latitude e longitude.
Exemplo requisição:
{urlApplication}/viabilidade/caixasRotasSugeridas?raio=200&endereco=Rua tomé de souza, 845, funcionários, BH - MG&qtdRotas=5
O retorno será uma lista de caixas que estão dentro raio com os seguintes atributos:
fid: Atributo identificador da caixa.qtdPortasSplitter: Quantidade total de portas de splitters dentro da caixa.
fidTipoCaixaEmenda: Atributo que determina o tipo da caixa (1 = Caixa emenda, 2 = CTO, 3 = Terminador óptico e 4 = Caixa de atendimento híbrido).
qtdEquipamentosPacpon: Quantidade total de equipamentos ethernet dentro da caixa.
qtdPortasEthernetOcup: Quantidade total de portas ocupadas de equipamentos ethernet dentro da caixa.
geometryCaixaEmenda: Geometria que representa a posição da caixa no formato WKT.
qtdPortasSplitterDisp: Quantidade total de portas disponíveis de splitters dentro da caixa.
capacidade: Capacidade da caixa.
qtdPortasSplitterOcup: Quantidade total de portas ocupadas de splitters dentro da caixa.
qtdClientes: Quantidade de clientes na caixa.
qtdTotalDisponivel: Quantidade total de portas disponíveis, resultado da soma de portas splitter e de ethernet.
qtdSplitter: Quantidade total de splitters dentro da caixa.
distancia: Distância radial em metrod entre o ponto de análise de viabilidade e a caixa.
qtdPortasEthernetDisp: Quantidade total de portas disponíveis de equipamentos ethernet dentro da caixa.
indAreaAtendimentoCto: Atributo que identifica se a caixa está dentro de uma área de atendimento ou não (1 = sim, 0 = não)
tipoCodigo: Atributo de descrição e tipo da caixa.
qtdPortasEthernet: Quantidade total de portas de equipamentos ethernet dentro da caixa.
distanciaRotaSugerida: Distância em metros da rota sugerida.
geometriaRotaSugerida: Geometria da rota sugerida no formato WKT.
- Consulta de Caixas/Lances:
Requisição do tipo
GET
. Os parâmetros devem ser passados na URL.
Atributos:
raio*: Atributo em metros do tipo double. Indica o raio da consulta de caixas a partir do endereço informado.endereco**
latitude**: deve ser informada em EPSG:4326.
longitude**: deve ser informada em EPSG:4326.
googlePlaceId**: Identificador de endereços do Google. Pode ser obtido realizando a consulta de endereços do serviço acima.
**Devem ser informados endereco ou googlePlaceId ou latitude e longitude.
Exemplo requisição:
{urlApplication}/viabilidade/caixasLances?raio=200&endereco=Rua tomé de souza, 845, funcionários, BH - MG
O retorno será uma lista de caixas que estão dentro raio com os seguintes atributos:
tipoCodigo: Atributo de descrição e tipo da caixa.distancia: Distância radial em metros entre o ponto de análise de viabilidade e a caixa.
fid: Fid da caixa retornada.
qtdClientes: Quantidade total de clientes dentro da caixa.
qtdLancesCabo: Quantidade total de lances de cabo dentro da caixa.
geometryCaixaEmenda: Geometria que representa a posição da caixa no formato WKT.
- Consulta de Caixas/Lances com rotas sugeridas:
Requisição do tipo
GET
. Os parâmetros devem ser passados na URL.
Atributos:
raio*: Atributo em metros do tipo double. Indica o raio da consulta de caixas a partir do endereço informado.endereco**
qtdRotas*: Atributo do tipo integer, menor ou igual a 5. Indica a quantidade máxima de rotas sugeridas.
latitude**: deve ser informada em EPSG:4326.
longitude**: deve ser informada em EPSG:4326.
googlePlaceId**: Identificador de endereços do Google. Pode ser obtido realizando a consulta de endereços do serviço acima.
**Devem ser informados endereco ou googlePlaceId ou latitude e longitude.
Exemplo requisição:
{urlApplication}/viabilidade/caixasLancesRotasSugeridas?raio=200&endereco=Rua tomé de souza, 845, funcionários, BH - MG&qtdRotas=5
O retorno será uma lista de caixas que estão dentro raio com os seguintes atributos:
fid: Atributo identificador da caixa.fidTipoCaixaEmenda: Atributo que determina o tipo da caixa (1 = Caixa emenda, 2 = CTO, 3 = Terminador óptico e 4 = Caixa de atendimento híbrido).
geometryCaixaEmenda: Geometria que representa a posição da caixa no formato WKT.
capacidade: Capacidade da caixa.
qtdClientes: Quantidade de clientes na caixa.
qtdLancesCabo: Quantidade total lances de cabo associados a caixa.
distancia: Distância radial em metrod entre o ponto de análise de viabilidade e a caixa.
tipoCodigo: Atributo de descrição e tipo da caixa.
distanciaRotaSugerida: Distância em metros da rota sugerida.
geometriaRotaSugerida: Geometria da rota sugerida no formato WKT.
- Distância da rota sugerida:
Requisição do tipo
GET
. Os parâmetros devem ser passados na URL.
Atributos:
fidCliente*: identificador do cliente para qual deseja encontrar a rota sugerida.fidCaixa: Identificador da caixa que fará o atendimento ao cliente informado.
Exemplo requisição:
{urlApplication}/viabilidade/distanciaRotaSugerida?fidCaixa=216981&fidCliente=2162
O retorno será uma rota sugerida entre a caixa e o cliente com os seguintes atributos:
success: Atributo informando o sucesso ou não da requisição.distancia: Distância da rota entre a caixa e o cliente a ser atendido.
rotaSugerida: Geometria da rota em formato WKT.
- Facilidade:
Requisição do tipo
GET
. Os parâmetros devem ser passados na URL.
Atributos:
raio*: Atributo em metros do tipo double. Indica o raio da consulta de caixas a partir do endereço informado.endereco**
latitude**: deve ser informada em EPSG:4326.
longitude**: deve ser informada em EPSG:4326.
googlePlaceId**: Identificador de endereços do Google. Pode ser obtido realizando a consulta de endereços do serviço acima.
estacao***: Atributo não obrigatório do tipo int. 1 caso queira o retorno, 0 caso não queira.
caixaEmenda***: Atributo não obrigatório do tipo int. 1 caso queira o retorno, 0 caso não queira.
cto***: Atributo não obrigatório do tipo int. 1 caso queira o retorno, 0 caso não queira.
cah***: Atributo não obrigatório do tipo int. 1 caso queira o retorno, 0 caso não queira.
terminalOptico***: Atributo não obrigatório do tipo int. 1 caso queira o retorno, 0 caso não queira.
hub***: Atributo não obrigatório do tipo int. 1 caso queira o retorno, 0 caso não queira.
**Devem ser informados endereco ou googlePlaceId ou latitude e longitude.
***Atributos não obrigatórios. Caso não informar, todos serão retornados. Se setar um ou mais deles com 1, apenas eles serão retornados.
Exemplos requisições:
{urlApplication}/viabilidade/facilidade?raio=100&endereco=Avenida Bias Fortes&latitude=-19.930691478687518&longitude=-43.940275216627946
{urlApplication}/viabilidade/facilidade?raio=100&latitude=-19.930691478687518&longitude=-43.940275216627946
{urlApplication}/viabilidade/facilidade?raio=100&latitude=-19.930691478687518&longitude=-43.940275216627946&cto=1&caixaEmenda=1
O retorno será uma lista de caixas e estações que estão dentro raio com os seguintes atributos:
fidTipoFeicao: Fid do tipo feição, 38 para estação e 87 caixa de emenda.fidFeicao: Atributo identificador da caixa ou estação.
tipo: Tipo da feição.
codigo: Código da feição.
distancia: Distância radial em metros entre o ponto de análise de facilidade e a caixa/estação.
x: Ponto da longitude da feição.
y: Ponto da longitude da feição.
fidTipoCaixaEmenda: Atributo que determina o tipo da caixa (1 = Caixa emenda, 2 = CTO, 3 = Terminador óptico, 4 = Caixa de atendimento híbrido e 5 = Hub).
Elementos Excluídos
- Consulta de feicões:
Requisição do tipo
GET
. Os parâmetros devem ser passados na URL.
Atributos:
tipoFeicao: Atributo em texto informando o tipo da feicao. Exibe apenas uma feicao, a qual foi informada. parâmetro pode receber os seguintes valores: poste, caixa, estacao, splitter.dataInicial: Atributo em texto informando a data inicial em que deseja obter os resultados. parâmetro deve receber os valores em formato yyyy-MM-dd: 2023-12-20, e deve se passar o parâmetro dataFinal.
dataFinal: Atributo em texto informando a data inicial em que deseja obter os resultados. parâmetro deve receber os valores em formato yyyy-MM-dd: 2023-12-20.
sorter*: Atributo em texto informando qual coluna vc deseja ordenar os resultados. parâmetro pode receber os seguintes valores: datahoraExclusao, fid, fidFeicao, fidTipoFeicao.
direction*: Atributo em texto informando o sentido da ordenação. parâmetro pode receber os seguintes valores: ASC, DESC.
Atributos Obrigatórios: sorter e direction
Exemplo requisição:
{urlApplication}/elementoExcluido/get?sorter=datahoraExclusao&direction=desc&dataInicial=2024-01-18&dataFinal=2024-01-19
O retorno será uma lista das feicoes que foram excluídas: Caso não seja passado nenhum parâmetro o retorno será uma lista de todas as feicoes que foram excluídas:
datahoraExclusao: Data Hora em que a feição foi excluída.descricao: Contém informações sobre a feição excluída.
fid: Fid da lista de feições excluídas.
fidFeicao: Fid da feição excluída.
tipoFeicao: Informa o tipo da feição excluída. Poste, caixa, estacao ou splitter.
tipoFeicaoDetalhado: Contém o tipo da feição. Se o tipo da feição for uma caixa, irá mostrar qual o tipo da caixa. CTO/HUB/Caixa de Emenda/CAH/TO