API do FTTH Docs Novo na 7.2

Responde "atende neste endereço?" com o mesmo veredito de três estados da tela de Viabilidade. Aceita coordenada direta ou um endereço em texto, geocodificado pelo servidor com o mesmo cache da tela.

Campos da resposta:

• veredito: atende (há caixa com porta livre no raio), talvez ou nao.
• atende: o mesmo veredito como booleano (true apenas para atende).
• motivo: vazio quando atende; sem_diagrama (há caixa perto ainda sem portas documentadas), sem_porta (caixas do raio estão cheias) ou sem_caixa (nada no raio).
• raio_m: o raio de busca usado, em metros (definido nos Ajustes do FTTH Docs).
• caixas: as caixas encontradas no raio, cada uma com distancia_m, portas_livres, portas_total e documentada.

curl -s "https://ravi.seuprovedor.com.br/api/api.php?token=SUA_CHAVE&action=ftth&operation=viabilidade&q=Rua+das+Flores+100,+Maringa+PR"

{
  "status": "success",
  "data": {
    "veredito": "atende",
    "atende": true,
    "motivo": "",
    "raio_m": 300,
    "caixas": [
      { "distancia_m": 74, "portas_livres": 5, "portas_total": 16, "documentada": true }
    ]
  }
}

Endereço que o geocodificador não encontra responde {"status":"error","message":"Address not found"}; chamada sem coordenada e sem q responde Provide lat/lng or q (address).

O agregado da planta, sem geometria: quantos projetos existem e como está a ocupação das portas.

{
  "status": "success",
  "data": {
    "projetos": 4,
    "portas": 72,
    "ocupadas": 12,
    "livres": 60,
    "ocupacao_pct": 17,
    "take_rate_pct": null
  }
}

take_rate_pct só vem calculado quando os projetos têm o campo casas passadas preenchido.

A lista de projetos da tela Meus Projetos, com os números de cada um. Aceita q para filtrar pelo nome.

Cada projeto vem com id, nome, descricao, lat/lng/zoom (onde o mapa abre), raio (raio de atendimento das caixas, em metros), casas (casas passadas), base (id do projeto base, 0 = nenhum), caixas, pops, cabos, metros, dutos, implantado (percentual de caixas implantadas ou certificadas; null sem caixas) e alterado.

curl -s "https://ravi.seuprovedor.com.br/api/api.php?token=SUA_CHAVE&action=ftth&operation=projetos"

Cria (id=0 ou ausente) ou edita um projeto, com a mesma validação da tela.

{ "status": "success", "data": { "id": 7, "areaOk": true } }

areaOk=false avisa que o projeto foi salvo mas o território enviado não pôde ser guardado (menos de três cantos válidos, por exemplo). Erros de validação vêm em message: nome (falta o nome) e coordenada (sem centro nem área).

Exclui o projeto id e tudo que foi desenhado nele — caixas, cabos, conexões e diagramas. Não tem volta.

{ "status": "success", "data": { "id": 7 } }