Dados abertos

API para desenvolvedores

O Iota fornece uma REST API para a consulta dos dados.

Os endpoints podem entregar o contéudo serializado em JSON, XML e YAML.

O content-type é definido automaticamente pelo header Accept. Por padrão, a resposta é no formato JSON.

Para pedir manualmente, utilize ?content-type=application/json para JSON, ?content-type=text/xml para XML, e ?content-type=text/x-yaml para YAML.

Todos os endpoints utilizam o domínio para descobrir qual a rede ativa para a consulta, isso influência no resultados obtidos.

Rede ativa no momento

Você esta no domínio 2013-2016-indicadores.cidadessustentaveis.org.br, rede ID 1

Endpoints

Endpoint Descrição Parâmetros aceitos
/indicators
Lista de todos os indicadores Filtros:
  • user_id=123
Se user_id for enviado, os indicadores desabilitado por usuário não retornam.
/users
Lista de todos os usuários e sua cidade -
/cities
Lista de todas as cidades -
/networks
Nome da rede e instituição do domínio acessado. -
/download-indicators
Valores calculados por indicador Filtros:
  • user_id=100,222,...
  • city_id=1,5,...
  • region_id=321,...
  • indicator_id=123,..
  • valid_from=2000-01-01,...
  • valid_from_begin=2000-01-01
  • valid_from_end=2010-01-01
Caso o campo region_id não for especificado, a consulta retorna os valores da cidade.
/download-variables
Valores das variáveis Todos os filtros do endpoint /download-indicators, exceto indicator_id, mais:
  • variable_id=123,..

/indicators voltar para endpoints

Exemplo de retorno:

$.get('/indicators', function(ret){console.log(ret)}); // after execute this

ret = {
    "indicators": [
        {
            "source": null,
            "sort_direction": null,
            "variety_name": null,
            "name_url": "crimes-violentos-nao-fatais",
            "visibility_user_id": 3,
            "axis": {
                "created_at": "2012-10-23 01:43:35.541972",
                "name": "Equidade, Justiça Social e Cultura de Paz",
                "id": 3
            },
            "indicator_admins": null,
            "chart_name": null,
            "created_at": "2013-08-20 16:39:54.30607",
            "all_variations_variables_are_required": 1,
            "formula": "$502 / $19 *100000",
            "indicator_type": "normal",
            "id": "251",
            "formula_human": "Número de crimes violentos não fatais / População total *100000",
            "featured_in_home": 0,
            "variable_type": "int",
            "period": "yearly",
            "observations": null,
            "name": "Crimes violentos não fatais",
            "visibility_country_id": null,
            "axis_id": 3,
            "tags": null,
            "goal_explanation": null,
            "goal_operator": null,
            "goal": null,
            "visibility_level": "private",
            "explanation": "Número de crimes violentos não fatais por cem mil habitantes",
            "goal_source": null,
            "user_id": 1,
            "dynamic_variations": null,
            "summarization_method": "sum"
        }
    ]
}

/users voltar para endpoints

Exemplo de retorno:

$.get('/users', function(ret){console.log(ret)}); // after execute this

ret = {
    "users": [
        {
            "city_summary": "Somos um movimento da sociedade civil que reúne setores empresariais, acadêmicos, movimentos sociais e cidadãos, mobilizados com o intuito de selecionar, propor e monitorar indicadores da cidade do Recife na busca da melhoria dos níveis de vida de todos os que habitam a capital pernambucana. Aberto a contribuições múltiplas, o ODR não tem destaque para lideranças individuais nem direcionamento político-partidário ou privilégio de grupos específicos. Nossa missão consiste em mobilizar a sociedade para  selecionar, propor e monitorar um conjunto de indicadores e metas que se constituam numa agenda de desenvolvimento sustentável para o Recife e que levem a transformá-la numa cidade melhor para se viver.",
            "city": {
                "uf": "PE",
                "pais": "br",
                "name_uri": "recife",
                "name": "Recife",
                "id": 110
            },
            "city_id": 110,
            "language": "pt-br",
            "regions_enabled": 1,
            "name": "Observatório do Recife",
            "id": "136"
        }
    ]
}

/cities voltar para endpoints

Exemplo de retorno:

$.get('/cities', function(ret){console.log(ret)}); // after execute this

ret = {
    "cities": [
        {
            "name_uri": "rio-branco",
            "summary": null,
            "id": 546,
            "longitude": "-67.824918",
            "pais": "brasil",
            "name": "Rio Branco",
            "latitude": "-9.9753837",
            "uf": "AC"
        }
    ]
}

/networks voltar para endpoints

Exemplo de retorno:

$.get('/networks', function(ret){console.log(ret)}); // after execute this

ret = {
    "network": {
        "institute": {
            "name": "Movimentos",
            "id": 2,
            "description": "administrado pelos movimentos"
        },
        "name": "Rede Social Brasileira por Cidades Justas e Sustentáveis",
        "id": 2
    }
}

/download-indicators voltar para endpoints

Exemplo de retorno:

$.get('/download-indicators', function(ret){console.log(ret)}); // after execute this

ret = {
    "data": [
        {
            "user_goal": null,
            "justification_of_missing_field": null,
            "valid_from": "01/01/2012",
            "indicator_id": 191,
            "region_id": null,
            "indicator_name": "Orçamento do município destinado a transporte público",
            "formula": "$322/$323*100",
            "city_name": "São Paulo",
            "axis_name": "Melhor Mobilidade, Menos Tráfego",
            "formula_human": "Valor total do orçamento, em reais, destinado a transporte público / Valor total do orçamento da área de transporte do município *100",
            "institute_id": 2,
            "city_id": 1,
            "period": "anual",
            "region_name": null,
            "value": "68.8442061662337",
            "observations": null,
            "variation_order": null,
            "goal_explanation": "Destinar 100% dos recursos públicos da área para a melhoria substantiva do transporte público.",
            "goal_operator": null,
            "tags": null,
            "goal": null,
            "sources": [
                "SEMPLA (Secretaria Municipal de Planejamento)"
            ],
            "explanation": "Percentual do orçamento do município destinado ao transporte público.",
            "updated_at": "2013-11-06 08:52:08.597114",
            "goal_source": "Programa Cidades Sustentáveis",
            "user_id": 11,
            "variation_name": "",
            "technical_information": null
        },
        {
            "user_goal": null,
            "justification_of_missing_field": null,
            "valid_from": "01/01/2012",
            "indicator_id": 191,
            "region_id": null,
            "indicator_name": "Orçamento do município destinado a transporte público",
            "formula": "$322/$323*100",
            "city_name": "Goiânia",
            "axis_name": "Melhor Mobilidade, Menos Tráfego",
            "formula_human": "Valor total do orçamento, em reais, destinado a transporte público / Valor total do orçamento da área de transporte do município *100",
            "institute_id": 2,
            "city_id": 180,
            "period": "anual",
            "region_name": null,
            "value": "32.1055485270197",
            "observations": null,
            "variation_order": null,
            "goal_explanation": "Destinar 100% dos recursos públicos da área para a melhoria substantiva do transporte público.",
            "goal_operator": null,
            "tags": null,
            "goal": null,
            "sources": [
                "Secretaria Municipal de Desenvolvimento Urbano Sustentável - Goiânia",
                "Secretaria Municipal de Trânsito, Transportes e Mobilidade - Goiânia"
            ],
            "explanation": "Percentual do orçamento do município destinado ao transporte público.",
            "updated_at": "2013-11-06 08:52:08.597114",
            "goal_source": "Programa Cidades Sustentáveis",
            "user_id": 763,
            "variation_name": "",
            "technical_information": null
        }
    ]
}

/download-variables voltar para endpoints

Exemplo de retorno:

$.get('/download-variables', function(ret){console.log(ret)}); // after execute this

ret = {
    "data": [
        {
            "source": null,
            "measurement_unit_name": null,
            "valid_from": "01/01/2000",
            "cognomen": "idh_municipal",
            "city_name": "São Paulo",
            "variable_id": 30,
            "city_id": 1,
            "is_basic": 1,
            "institute_id": 2,
            "period": "anual",
            "exp_source": null,
            "value": "0.841",
            "name": "Índice de Desenvolvimento Humano (IDH) Municipal",
            "observations": null,
            "updated_at": "2012-11-28 12:10:16.055272",
            "type": "num",
            "user_id": 11
        },
        {
            "source": null,
            "measurement_unit_name": null,
            "valid_from": "01/01/2000",
            "cognomen": "expect_vida",
            "city_name": "São Paulo",
            "variable_id": 28,
            "city_id": 1,
            "is_basic": 1,
            "institute_id": 2,
            "period": "anual",
            "exp_source": null,
            "value": "71.7",
            "name": "Expectativa de Vida: Esperança de vida ao nascer",
            "observations": null,
            "updated_at": "2013-08-18 13:24:36.795562",
            "type": "num",
            "user_id": 11
        }
    ]
}

Realização

Instituto Ethos de Empresas e Responsabilidade Social
/parceiros/instituto-ethos-de-empresas-e-responsabilidade-social
http://www.ethos.org.br
Rede Nossa São Paulo
/parceiros/rede-nossa-s%C3%A3o-paulo
http://www.nossasaopaulo.org.br/portal/
Rede Social Brasileira por Cidades Justas e Sustentaveis
/parceiros/rede-social-brasileira-por-cidades-justas-e-sustentaveis
http://rededecidades.ning.com/

Apoio

Fundação Avina
/parceiros/fundacao-avina
http://www.avina.net/esp/
Instituto Arapyaú
/parceiros/instituto-arapyau
http://www.arapyau.org.br/

Apoio de Mídia

A Tarde
/parceiros/tarde
Abril
/parceiros/abril
http://www.abril.com.br/
CBN
/parceiros/cbn
http://cbn.globoradio.globo.com/home/HOME.htm
Editora Globo
/parceiros/editora-globo
http://corp.editoraglobo.globo.com/
Meio Norte
/parceiros/meio-norte
Rádio Globo
/parceiros/radio-globo
http://radioglobo.globoradio.globo.com/home/HOME.htm
Rede Globo
/parceiros/rede-globo
http://redeglobo.globo.com/
Revista Piauí
/parceiros/revista-piaui

Parceiros Nacionais

ABEMA
/parceiros/abema-0
http://www.abema.org.br/site/pt-br/home/home.php
Afobras
/parceiros/afobras
http://www.afrobras.org.br/
Akatu
/parceiros/akatu
http://www.akatu.org.br/
Associação Brasileira dos Municípios (ABM)
/parceiros/associacao-brasileira-dos-municipios-abm
http://www.abm.org.br/
Atletas pela Cidadania
/parceiros/atletas-pela-cidadania
http://www.atletas.org.br/
CBCS
/parceiros/cbcs
http://www.cbcs.org.br/website/
Cenpec
/parceiros/cenpec
http://www.cenpec.org.br/
Dieese
/parceiros/dieese
http://www.dieese.org.br/
DPZ
/parceiros/dpz-0
http://dpz.com.br/
Escola de Governo
/parceiros/escola-de-governo
http://www.escoladegoverno.org.br/
Famurs
/parceiros/famurs
http://www.famurs.com.br/
Fórum Amazônia Sustentável
/parceiros/forum-amazonia-sustentavel
http://www.forumamazoniasustentavel.org.br/
Frente Nacional de Prefeitos
/parceiros/frente-nacional-de-prefeitos
http://www.fnp.org.br/home.jsf
Gife
/parceiros/gife
http://www.gife.org.br/
Greenpeace
/parceiros/greenpeace
http://www.greenpeace.org/brasil/pt/
Instituto 5 Elementos
/parceiros/instituto-5-elementos
http://www.5elementos.org.br/site/index.php
Instituto Democracia e Sustentabilidade
/parceiros/instituto-democracia-e-sustentabilidade
http://www.idsbrasil.net/
Instituto Saúde e Sustentabilidade
/parceiros/sa%C3%BAde-e-sustentabilidade
http://www.saudeesustentabilidade.org.br/
Instituto Socioambiental
/parceiros/instituto-socioambiental
http://www.socioambiental.org/
Instituto Cidade Democrática
/parceiros/icd
http://www.cidadedemocratica.org.br/
Mobilize
/parceiros/mobilize
http://www.mobilize.org.br/
Movimento de Combate a Corrupção Eleitoral (MCCE)
/parceiros/movimento-de-combate-corrupcao-eleitoral-mcce
http://www.mcce.org.br/site/
NEF - Núcleo de Estudos do Futuro
/parceiros/nef-n%C3%BAcleo-de-estudos-do-futuro
http://www.nef.org.br/
OAB Conselho Federal
/parceiros/oab-conselho-federal
http://www.oab.org.br/
ONU Habitat
/parceiros/onu-habitat
http://www.unhabitat.org/categories.asp?catid=9
Pnuma
/parceiros/pnuma
http://www.pnuma.org.br/
Rede de Ação Política pela Sustentabilidade (RAPS)
/parceiros/rede-de-acao-politica-pela-sustentabilidade-raps-0
http://www.raps.org.br/
Roland-Berger
/parceiros/roland-berger
http://www.rolandberger.com.br/
Sesc
/parceiros/sesc
http://www.sescsp.org.br/sesc/
SOS Mata Atlântica
/parceiros/sos-mata-atl%C3%A2ntica
http://www.sosma.org.br/
Todos pela Educação
/parceiros/todos-pela-educa%C3%A7%C3%A3o
http://www.todospelaeducacao.org.br/
Transition Brasil
/parceiros/transition-brasil
http://transitionbrasil.ning.com/
Trata Brasil
/parceiros/trata-brasil
http://www.tratabrasil.org.br/
União dos Vereadores do Brasil
/parceiros/uniao-dos-vereadores-do-brasil
http://www.uvbbrasil.com.br/novo/
Unicef
/parceiros/unicef
http://www.unicef.org/brazil/pt/
Vitae Civilis
/parceiros/vitae-civilis
http://www.vitaecivilis.org.br/
WWF
/parceiros/wwf
http://www.wwf.org.br/

Parceiros Internacionais

Aalborg
/parceiros/aalborg
http://www.sustainablecities.eu/
Conama
/parceiros/conama
DAC - Danish Architecture Centre
/parceiros/dac-danish-architecture-centre
http://www.dac.dk/
Eco City Builders
/parceiros/eco-city-builders
http://www.ecocitybuilders.org/
Ecodes
/parceiros/ecodes
http://www.ecodes.org/
Ford Foundation
/parceiros/ford-foundation
http://www.fordfoundation.org/
La Ciudad Verde
/parceiros/la-ciudad-verde
http://www.laciudadverde.co/2/
New Cities Foundation
/parceiros/new-cities-foundation
http://www.newcitiesfoundation.org/
Red Argentina de municipios frente al cambio climático
/parceiros/red-argentina-de-municipios-frente-al-cambio-climatico
http://www.gobiernolocal.gob.ar/index.php?option=com_flexicontent&view=items&Itemid=15&cid=5&id=158637
Red Paraguaya por Ciudades Sustentables
/parceiros/red-paraguaya-por-ciudades-sustentables
http://ciudadessustentables.org/
Red Uruguaya de Ciudades Justas Democraticas y Sustentables
/parceiros/red-uruguaya-de-ciudades-justas-democraticas-y-sustentables
http://www.redciudades.org.uy/
Sustainable Cities
/parceiros/sustainable-cities
http://sustainablecities.net/
Sustainable Cities Europe
/parceiros/sustainable-cities-europe
http://www.sustainablecities.eu/
This Big City
/parceiros/big-city
http://thisbigcity.net/

Patrocinadores

ALCOA
/parceiros/alcoa
http://www.alcoa.com/brasil/pt/info_page/home.asp
Anamma
/parceiros/anamma
http://www.anamma.com.br/
Bradesco
/parceiros/bradesco
http://www.bradesco.com.br/html/classic/index.shtm
BRF
/parceiros/brf
http://www.brf-br.com/
Caixa Econômica Federal
/parceiros/caixa-econ%C3%B4mica-federal
http://www.caixa.gov.br/
CPFL Energia
/parceiros/cpfl-energia
http://www.cpfl.com.br/
Dualtec
/parceiros/dualtec
http://www.dualtec.com.br/
Embraer
/parceiros/embraer
http://www.embraer.com/pt-BR/Paginas/Home.aspx
IBM
/parceiros/ibm
http://www.ibm.com/br/pt/
Instituto Cyrela
/parceiros/instituto-cyrela
http://www.institutocyrela.com.br/site/home
Instituto Semeia
/parceiros/instituto-semeia
http://www.semeia.org.br/
Itaipu Binacional
/parceiros/itaipu-binacional
http://www.itaipu.gov.br/
Itaú
/parceiros/ita%C3%BA
http://www.itau.com.br
Natura
/parceiros/natura
http://www.natura.net/br/index.html
Nestlé
/parceiros/nestl%C3%A9
http://www.nestle.com.br/site/home.aspx
Porto Seguro
/parceiros/porto-seguro
http://www.portoseguro.com.br/
Promon
/parceiros/promon
http://www.promon.com.br/
Safra
/parceiros/safra
http://www.safra.com.br/portugues/index2.asp
Santander
/parceiros/santander
https://www.santander.com.br/
Vale
/parceiros/vale
http://www.vale.com/PT/Paginas/Landing.aspx
Votorantin
/parceiros/votorantin
http://www.institutovotorantim.org.br/pt-br/Paginas/home.aspx
VR
/parceiros/vr
http://www.vr.com.br/portal/
Walmart
/parceiros/walmart
http://www.walmart.com.br/