osmc:Api

Rascunho sobre APIs. Reúne definições dispersas em issues.

Subdomínio default: api.afa.codes subdomínio teste: api.test.afa.codes

https://github.com/osm-codes/gridMap-draftPages/issues/82: Codificação do CEP é definitiva, vale o hifem: https://test.afa.codes/BR-49750~CMH https://test.afa.codes/BR-49750-CMH

https://github.com/osm-codes/BR_new/issues/10: Capital do pais (fica no nivel 2) https://afa.codes/BR-DF-Brasilia~FRRS https://afa.codes/BR-DF~FRRS https://afa.codes/CO-DC~5ST5ZQD Capital do estado (permite nivel 3 repetindo o nivel 2 com suas 2 letras) https://afa.codes/BR-SP-SaoPaulo~FRRS https://afa.codes/BR-SP-SP~FRRS https://afa.codes/BR-SP-SP~MCGBM7

https://github.com/osm-codes/gridMap-draftPages/issues/69 RegistroBR: Os domínios municipais do Brasil registrados com mais de duas letras podem se tornar redirecionadores:

   Sem ambiguidade quando usados os três níveis;

   Algumas ambiguidades quando usado BR-dominio;
   9guacu exigiu mudanças no nginx;
   54 cidades com dominio

https://osm.codes/BR-Sampa~MCGBM7 https://osm.codes/BR-SP-Sampa~MCGBM7

---

de https://github.com/osm-codes/WS/issues/26:

Não sei se entendi,

   Dado inédito: aquele que ninguém tinha acesso público antes, mas com a publicação AddressForAll passou a ter. Tipicamente dados doados por e-mail (teve um só caso até hoje que fomos buscar um DVD).

   Dado não-inédito: o contrário de inédito. Em geral se a prefeitura oferece Download já deixa de ser inédito automaticamente... A questão é se foi antes ou depois da AddressForAll publicar. Pode conferir em archive.org

... Um dia todos deixam de ser inéditos, então nosso objetivo aqui é classificar como "inédito" tudo aquilo que no dia que fizemos a primeira publicação online (atualmente o /teste2) era comprovadamente inédito.

Apesar de muitos dados não serem inéditos, sempre bom lembrar dos diferenciais dos dados da AddressForAll, mesmo quando não são inéditos :

   Segurança Jurídica: publicamos todas as evidências (de dados e de licença) e garantimos as licenças indicas.
   Estabilidade: os dados são os mesmos por 20 anos, não se perdem, não se confundem e os mais atuais são diferenciáveis dos mais velhos, quando existe mais de uma versão do mesmo dado. Se você pagou IPTU ou registrou imóvel com relação ao cenário de uma certa data, esse cenário não é perdido.
   Padronização semântica: não precisa filtrar e analisar, já fizemos isso e oferecemos um padrão de dados estável.
   Curadoria: os conjuntos de dados que publicamos são prevaimente avaliados como consistentes e relevantes.

Dados publicados em https://addressforall.org/downloads/ com a tag `[unprecedented]` para indicar que são inéditos.