Edição das 17h32min de 4 de outubro de 2013

Objetivo

Expor dados estatísticos governamentais do estado de São Paulo.

URI

http://api-imp.seade.gov.br

Código HTTP de Retorno

• Sucesso: 200.

• Erro: 404.

Recursos Disponíveis

Localidade

GET

• Path: /localidade

• Parâmetros: código

Caso o código não seja passado, a busca trará todas as localidades.

Sintaxe de chamada

curl -X GET "http://api-imp.seade.gov.br/localidade"

ou

curl -X GET "http://api-imp.seade.gov.br/localidade/{codigo}"

Retorno JSON

Exemplo:

{
   "localidade": {
       "codigo": "10",
       "nome": "Altinópolis",
       "nivel": "Altinópolis",
       "codigo_pai": "731",
       "nome_pai": "Região de Governo de Ribeirão Preto"
   }
}

Variável

GET

• Path: /variavel
• Parâmetros: código

Caso o código não seja passado, a busca trará todas as localidades.

Sintaxe de chamada

curl -X GET "http://api-imp.seade.gov.br/variavel"

ou

curl -X GET "http://api-imp.seade.gov.br/variavel/{codigo}"

Retorno JSON

Exemplo:

{
   "variavel": {
       "codigo": "5",
       "nome": "Área",
       "unidade": "(Em km2)",
       "fonte": "Instituto Brasileiro de Geografia e Estatística–IBGE.",
       "nota": "A partir de agosto de 2008, os dados referentes à área dos municípios paulistas ..."
   }
}

Consulta

GET

Path: /consulta

Parâmetros: localidade/variável/ano

Exemplo de chamada

curl -X GET "http://api-imp.seade.gov.br/consulta/16/15/0"

Retorno JSON

Exemplo:

{
   "consulta": [
       {
           "loc_cod": "16",
           "loc_nome": "Americana",
           "unid_nome": "(Por mil nascidos vivos ou mortos)",
           "nome_pai": "Região Metropolitana de Campinas",
           "var_cod": "15",
           "var_nome": "Teatros – Salas Disponíveis",
           "d_1995": "2",
           "d_1997": "2",
           "d_2000": "2",
           "d_2003": "1"
       },
       {
           "loc_cod": "16",
           "loc_nome": "Americana",
           "unid_nome": "(Por mil nascidos vivos ou mortos)",
           "nome_pai": "Região de Governo de Campinas",
           "var_cod": "15",
           "var_nome": "Teatros – Salas Disponíveis",
           "d_1995": "2",
           "d_1997": "2",
           "d_2000": "2",
           "d_2003": "1"
       }
   ]
}