osmc:Api

Página rascunho, em construção.

Lembrete: osmc:Gits lista as funções utilizadas pelas APIs de resolução de códigos. web:Documentação dos sites indica a arquitetura usada. a4a:Convenções/Dados/SQL precisa centralizar a descrição de tabelas.

Secundárias. site:WS foi iniciada apenas, não tem nada. osmc:Comparação com referencia as APIs, pode ter algo a destacar.

APIs AFAcodes

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

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

Brasil

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

Colômbia

https://github.com/osm-codes/CO_new/issues/17

Quanto ao so do hifem , "-", no lugar de "~", atualmente podemos referenciar cidades através do nome, por exemplo CO-RIS-Dosquebradas-15NTJ ou através de DIVIPOLA (jurisd_local_id), CO-66170-15NTJ, e ambos retornam o canônico (com "~").

Quanto à URL e representações canônicas, sim, sempre com o ~ separando, mas os usuários preferem usar - de modo que não é exigido como formato de input, apenas formatação output canônica.

CO-A-Itagui = código Divipola
código Divipola = código Divipola
CO-A-Igi = código Divipola
CO-ANT-Igi = código Divipola

API de downloads

Ver também a4a:Convenções/Dados/SQL#download.redirects.

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

Alguns requisitos de download foram sumarizados na issue #26 de WS do AFAcodes, mas são requisitos do projeto Digital-guard:

• 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 :

1. Segurança Jurídica: publicamos todas as evidências (de dados e de licença) e garantimos as licenças indicas.
2. 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.
3. Padronização semântica: não precisa filtrar e analisar, já fizemos isso e oferecemos um padrão de dados estável.
4. Curadoria: os conjuntos de dados que publicamos são prevaimente avaliados como consistentes e relevantes.