#735·BrasilAPI

Adicionar contexto regional, provedores e cobertura de internet ao endpoint de DDD

Author: Luana598Created Nov 13, 2025Updated Nov 13, 2025

O endpoint atual /ddd/v1/{codigo} retorna apenas o estado e as cidades correspondentes a um DDD, conforme exemplo:

{ "state": "SP", "cities": ["São Paulo", "Guarulhos", "Campinas"] }

Propõe-se expandir a resposta com novos campos que tornem o endpoint mais informativo e útil para aplicações que envolvem dados regionais e de telecomunicações.

novos campos sugeridos

Campo Tipo Descrição
region string Região geográfica do Brasil (ex: "Sudeste", "Nordeste")
main_providers array Principais operadoras telefônicas atuantes na área
city_count integer Quantidade total de cidades dentro do DDD
internet_coverage string Nível médio de cobertura de internet (ex: "Alta", "Média", "Baixa")
source array Fontes oficiais dos dados (ex: ["IBGE", "Anatel"])

proposta de Implementação

  • Mapear região a partir da sigla do estado (state);

  • Definir main_providers e internet_coverage com base em dados da Anatel e NIC.br;

  • Contar as cidades (city_count) com base na lista já retornada;

  • Atualizar source para listar as fontes usadas;

  • Revisar documentação e exemplo JSON.