A Rede Moara oferece acesso público a seus dados por meio de uma API simples e prática.
Qualquer pessoa pode consultar informações sobre projetos, códigos, publicações e outros conteúdos cadastrados no portal, de forma estruturada e organizada.
Os dados estão disponíveis em formato digital aberto, facilitando a exploração, o uso e a integração com outros sistemas, apoiando desenvolvedores, pesquisadores e interessados em Ciência, Tecnologia e Inovação a trabalhar com informações atualizadas e confiáveis.
A Rede Moara utiliza a infraestrutura padrão da API REST do WordPress, disponível nativamente desde a versão 4.7. Isso significa que o portal já possui um mecanismo integrado para disponibilizar seus conteúdos em formato estruturado, sem necessidade de plugins adicionais.
Ao instalar o WordPress, é criada automaticamente a rota principal:
/wp-json
A API converte automaticamente as informações armazenadas no banco de dados (MySQL) para o formato JSON: um padrão leve, amplamente utilizado e compatível com diversas linguagens de programação, como Python, JavaScript, Java e PHP.
Como os dados disponibilizados pela Rede Moara são públicos, não é necessária autenticação para consultas básicas. Qualquer pessoa pode realizar requisições do tipo GET e acessar as informações disponíveis.
Abaixo, apresentamos os pontos de acesso para cada área temática da Rede Moara.
Aviso de Dados: Se ao clicar em um link você vir apenas dois colchetes [], significa que a “prateleira” desta rede está pronta para receber dados, mas ainda não possui registros homologados.
Sua iniciativa pode ser a próxima a figurar em nossa base de dados aberta, servindo de fonte para pesquisadores de todo o Brasil.
A API REST da Rede Moara permite acesso público aos conjuntos de dados cadastrados no portal. Os dados são disponibilizados em formato JSON por meio da API REST padrão do WordPress.
| Campo | O que é? | Descrição para o Usuário |
id | Identificador | O número único de registro deste item no sistema. |
date | Data de Cadastro | O dia e hora em que a iniciativa foi publicada na rede. |
slug | Atalho (Link) | O nome amigável usado para gerar o endereço (URL) da página. |
title.rendered | Nome da Iniciativa | O nome oficial do projeto, software ou repositório. |
excerpt.rendered | Resumo | Uma breve descrição sobre o que se trata a iniciativa. |
| Campos Técnicos (ACF) | ||
descricao_codigo | Descrição Técnica | Detalhes sobre como o código-fonte foi construído. |
software_vinculado | Software Base | Indica se a iniciativa utiliza ou depende de outro software. |
linguagens | Linguagens | As linguagens de programação (ex: Python, PHP) utilizadas. |
fonte_citacao | Fonte | A referência ou origem de onde os dados foram extraídos. |
Quando um sistema “pergunta” algo para a nossa API, ela responde de forma organizada. Abaixo, você vê um exemplo de como os dados chegam. Note que os dados reais ficam dentro de blocos identificados por nomes simples.
{
"id": 14696,
"title": { "rendered": "CIVIS" },
"slug": "civis",
"metadata": {
"descricao_codigo": "Plataforma de Ciência Cidadã desenvolvida pelo Ibict.",
"software_vinculado": "eu-citizen.science",
"linguagens": "Python, JavaScript",
"fonte_citacao": "Repositório Ibict"
}
}Como as redes podem conter centenas de registros, a API permite que você organize como deseja receber os dados para não sobrecarregar sua conexão.
Paginação: Por padrão, a API mostra 10 itens por vez. Se você quiser ver a próxima página de resultados, basta adicionar ?page=2 ao final do link.
Quantidade: Quer ver mais itens de uma vez? Use ?per_page=50 (máximo de 100).
Busca: Você pode pesquisar por palavras-chave em toda a rede usando ?search=civis.