[MVP] Portais de dados abertos (CKAN) no Brasil, documentação em Português

[fititnt]

• VERSÃO ONLINE:
  • Português: https://editor.swagger.io/?url=https://hapi.etica.ai/api/BR/portais-ckan-brasil/por/openapi.yaml
  • Inglês
    • https://editor.swagger.io/?url=https://hapi.etica.ai/api/BR/portais-ckan-brasil/por/openapi.yaml

---

Atalhos Rápidos

• https://dadosabertos.social/t/listas-de-portais-de-dados/19
  • Brasil:
    • https://dados.gov.br/pagina/outras-iniciativas
    • https://wiki.dados.gov.br/
    • https://colaboradados.com.br/
  • Mundo:
    • http://dataportals.org/
    • https://opendatainception.io/
    • https://datashades.info/
    • https://dadosabertos.social/t/datashades-info-informacoes-sobre-portais-que-usam-ckan/128
• Trivia: O que são CODs
  • https://www.youtube.com/watch?v=CFUs8S0MPIY

PS: o @augusto-herrmann esta de parabéns!!! Vai facilitar bastante para gente já ter catalogado!

---

Tópico sobre Produto Mínimo Viável (em inglês: MVP) da documentações interativas (como as geradas usando OpenAPI) de portais CKAN usados no Brasil.

Sobre nosso foco aqui

Existem várias iniciativas de uso de dados abertos no Brasil e no mundo. Porém o foco otimizações do HXL-CPLP é a curto e médio prazo incentivar iniciativas da comunidade de software desenvolvendo de ferramentas reusáveis, bem como melhorar interoperabilidade relacionada a uso humanitário [vide notas] e, em seguindo lugar, direitos humanos em geral.

Em geral, isso significa que pelo menos 90% dos dados processados não são dados públicos. Padrões como o HXL (Humanitarian Exchange Language) podem permitir processamento até mesmo de arquivo de Excel em disco ou Google Planilhas compartilhado (o que permitiria processamento diretamente por gerentes de informação que trabalham na ultima milha, como coordenadores de TI de hospitais ou prefeituras). Não obstante, esse uso potencial requer que dados importantes não só a nível internacional (saiba mais sobre os CODs https://www.youtube.com/watch?v=CFUs8S0MPIY), mas a nível local, tenham sido preparados meses antes.

Nos do @HXL-CPLP e @EticaAI entendemos que é "complicado" pensar em coisas que não podem ser debugadas em público com dados reais, porém mesmo que iniciativas não fiquem prontas para a crise internacional do Covid, o uso de padrões abertos, convenções sobre vocabulários e otimização para quem trabalha em campo processando dados sensíveis é uma abordagem mais focada de como os dados abertos são usados em momentos de crise.

---

vide Humanitarismo na Wikipedia
O Humanitarismo se baseia em quatro princípios:

Humanidade
O sofrimento humano deve ser combatido a todo custo. Não importando onde ele seja encontrado e prestando uma atenção maior àqueles mais vulneráveis.

Neutralidade
A ajuda humanitária não pode favorecer nenhum dos lados do conflito armado ou outra disputa.

Imparcialidade
A ajuda humanitária só pode ocorrer baseada casos de necessidade, sem discriminação.

Independência
Objetivos humanitários possuem autonomia sobre objetivos políticos, econômicos, militares e outros.

Esses princípios fazem a distinção entre questões Humanitárias e questões políticas, econômicas, religiosas, ideológicas, militares e etc. Eles evitam que entidades mal-intencionadas usem o humanitarismo como justificativa para cometer atos de natureza duvidosa ou enviesados para benefício próprio.

---

Edição em 2021-06-06 13:47 UTC: adicionado 'versão online'

[fititnt]

Problema! 11 sites CKAN estão com problema no CORS

Creio que vale a pena começar avisar os responsáveis pelos portais. Vou deixar aqui como referência. Pode demorar alguns meses, ou pelo menos algumas semanas.

Sites com problemas em Cross-Origin Resource Sharing (CORS)

• https://dados.gov.br/api/3/action/package_list?limit=250
• https://dados.al.gov.br/catalogo/api/3/action/package_list?limit=250
• http://dados.df.gov.br/api/3/action/package_list?limit=250
• https://dados.pbh.gov.br/api/3/action/package_list?limit=250
• http://dados.recife.pe.gov.br/api/3/action/package_list?limit=250
• http://dados.natal.br/api/3/action/package_list?limit=250
• https://dados.rs.gov.br/api/3/action/package_list?limit=250
• http://dados.tce.rs.gov.br/api/3/action/package_list?limit=250
• http://dados.sc.gov.br/api/3/action/package_list?limit=250
• https://www.governoaberto.sp.gov.br/api/3/action/package_list?limit=250
• http://dados.prefeitura.sp.gov.br/api/3/action/package_list?limit=250

Exemplo com erro

Sites com CORS OK

Da lista atual, apenas estes passam explicitamente.

• https://dados.fortaleza.ce.gov.br/api/3/action/package_list?limit=250
• https://dados.portoalegre.rs.gov.br/api/3/action/package_list?limit=250

Exemplo funcionando:

Informações rápidas para responsáveis pelos portais (aka como resolver o problema)

• Sobre CORS:
  • https://developer.mozilla.org/pt-BR/docs/Web/HTTP/CORS
• Como resolver
  • Via configuração do próprio CKAN:
    • https://github.com/ckan/ckan/blob/master/doc/maintaining/configuration.rst#cors-settings
      • ckan.cors.origin_allow_all = True
  • Via servidor: https://enable-cors.org/server.html
    • Apache: https://enable-cors.org/server_apache.html
    • NGinx: https://enable-cors.org/server_nginx.html
• Exemplo de site que permite testar online:
  • https://www.test-cors.org/
  • Pode usar como referência a URL: https://data.humdata.org/api/3/action/package_list?limit=250

[augusto-herrmann]

O e-mail de contato dos responsáveis pelo portal dados.gov.br é dadosabertos@cgu.gov.br. Sugiro informar lá sobre o problema.

[fititnt]

Obrigado pela dica do e-mail mais específico, @augusto-herrmann ! Mandei cópia para eles.

Estou vendo outras coisas aqui no HXL-CPLP/Auxilium-Humanitarium-API (como preparar para tradução para outras línguas de como usar OpenAPI) porém a questão de de facto poder usar via web é util para quem for consumir os arquivos.

Aos poucos vai indo.