API-BIBLIOTECA-DIGITAL

Apresentação

A API, sigla em inglês para Interface de Programação de Aplicativos, foi desenvolvida para permitir a criação de aplicações, que tornem possível a visualização de informações das obras antigas e raras e acervo de estatísticas do Seade desde o século XIX, em outros sítios ou a reutilização em sistemas desenvolvidos por usuários, mediante acesso direto à base de informações, sempre atualizadas da Biblioteca Digital. O formato, em código aberto, é o JSON e não há necessidade de cadastro ou qualquer outro procedimento para o acesso.

URI

http://api-bibliotecadigital.seade.gov.br/v1

Código HTTP de Retorno

• Sucesso: 200.

• Erro: 404.

Recursos Disponíveis

Tipos de Documentos

GET

• Path: /tipo
• Parâmetros: id

* Não é obrigatório a informação do id .

* Não coloque o id se quiser ver todos os tipos de documentos.

Sintaxe de chamada

curl -X GET "http://api-bibliotecadigital.seade.gov.br/v1/tipo"

ou

curl -X GET "http://api-bibliotecadigital.seade.gov.br/v1/tipo/1"

Retorno JSON

Exemplo:

{
   - tipo: [
       - {
           id: "1",
           tipo: "Periódico",
         },
       - {
           "id: "2",
           tipo: "Monografia",
       },
   ]
}

Coleções

GET

• Path: /colecao
• Parâmetros: id

* Não é obrigatório a informação do id .

* Não coloque o id se quiser ver todas as coleções.

Sintaxe de chamada

curl -X GET "http://api-bibliotecadigital.seade.gov.br/v1/colecao"

ou

curl -X GET "http://api-bibliotecadigital.seade.gov.br/v1/colecao/24"

Retorno JSON

Exemplo:

{
   - colecao: [
       - {
           id: "24",
           tipo: "Perfil Municipal",
           dt_atualizacao: "2017-10-02 15:08:26",
       }
   ]
}

Autores

GET

• Path: /autor
• Parâmetros: id

* Não é obrigatório a informação do id .

* Não coloque o id se quiser ver todos os autores.

Sintaxe de chamada

curl -X GET "http://api-bibliotecadigital.seade.gov.br/v1/autor"

ou

curl -X GET "http://api-bibliotecadigital.seade.gov.br/v1/autor/543"

Retorno JSON

Exemplo:

{
   - autor: [
       - {
           id: "543",
           nome: "AFTALION, Albert",
           dt_atualizacao: "2014-09-08 15:26:04",
       }
   ]
}

Nota

GET

• Path: /nota

• Parâmetros: código

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

Sintaxe de chamada

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

ou

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

Retorno JSON

Exemplo:

{
   "nota": {
       "codigo": "100",
       "descricao": "No modelo de projeção utilizado, ou seja para os anos de 1997 e 1998, foi considerado um ajuste na ..."
   }
}

Variável

GET

Use o formato abaixo para buscar uma variável por requisição.

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

Para buscar todas as variáveis, é necessário informar os parâmetros de paginação, conforme a sintaxe abaixo.

• Path: /variavel?offset={inicial}&limit={limite}

Sintaxe de chamada

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

ou

curl -X GET "http://api-imp.seade.gov.br/v1/variavel?offset=0&limit=10"

Retorno JSON

Exemplo:

{
  "variavel": {
     "codigo": "55",
     "nome": "População",
     "unidade": "Não possui unidade",
     "periodo": "1980-2013",
     "definicao": "Não possui definicao",
     "fonte": [
        "Instituto Brasileiro de Geografia e Estatística – IBGE.",
        "Fundação Seade."
     ],
     "nota": [
       "Os dados referem-se aos municípios de acordo com a divisão administrativa do Estado de São Paulo vigente no respectivo período:
         - até 1982, 571 municípios;          
         - de 1983 a 1992, 572 municípios;
         - de 1993 a 1996, 625 municípios;
         - a partir 1997, 645 municípios.",
       "As populações aqui apresentadas resultam de projeções elaboradas pelo método dos componentes demográficos. Este método considera as tendências de fecundidade, 
        mortalidade e migração, a partir das estatísticas vitais processadas na Fundação Seade, e a formulação de hipóteses de comportamento futuro para estes 
        componentes. A população de base, por idade e sexo, considera os resultados correspondentes aos diversos Censos Demográficos realizados pelo IBGE. As 
        populações projetadas referem-se a 1º de julho de cada ano. Para maiores informações, ver 
        <a href="http://www.seade.gov.br/produtos/projpop/pdfs/projpop_metodologia.pdf" target="_blank">Metodologia</a>."
     ]
  }
}

Perfil Municipal - informações do município

GET

Use o formato abaixo para buscar uma variável por requisição.

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

Para buscar todas as variáveis, é necessário informar os parâmetros de paginação, conforme a sintaxe abaixo.

• Path: /infmun/{codigo}

Sintaxe de chamada

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

ou

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

Retorno JSON

Exemplo:

{

 "infmun": [
   {
     "codigo_localidade": "503",
     "localidade": "São Paulo",
     "loc_pai": "Região Metropolitana de São Paulo",
     "loc_pai2": "Total do Estado de São Paulo",
     "aniversario": "25 de janeiro",
     "link_historico": "http://www.seade.gov.br/produtos/perfil/hist/hist_503.pdf",
     "santo_padroeiro": "Nossa Senhora da Penha de Franca"
   }
 ]

}

Perfil Municipal - dados

GET

Use o formato abaixo para buscar uma variável por requisição.

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

Para buscar todas as variáveis, é necessário informar os parâmetros de paginação, conforme a sintaxe abaixo.

• Path: /perfil/{codigo}

Sintaxe de chamada

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

ou

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

Retorno JSON

Exemplo:

{

 "perfil": [
   {
     "codigo_localidade": "503",
     "localidade": "São Paulo",
     "codigo_localidade_pai": "681",
     "nome_localidade_pai": "Região Metropolitana de São Paulo",
     "codigo_variavel": "1",
     "variavel": "Crédito Rural",
     "unidade": "(Em reais de 2015)",
     "periodo": "1985/1989-2011",
     "ano": {
       "2011": "2.339.704.690"
     }
   },
   {
     "codigo_localidade": "503",
     "localidade": "São Paulo",
     "codigo_localidade_pai": "681",
     "nome_localidade_pai": "Região Metropolitana de São Paulo",
     "codigo_variavel": "2",
     "variavel": "Crédito Rural Agricultura",
     "unidade": "(Em reais de 2015)",
     "periodo": "1985/1989-2011",
     "ano": {
       "2011": "1.605.918.449"
     }
   },
   {
     "codigo_localidade": "503",
     "localidade": "São Paulo",
     "codigo_localidade_pai": "681",
     "nome_localidade_pai": "Região Metropolitana de São Paulo",
     "codigo_variavel": "3",
     "variavel": "Crédito Rural Pecuária",
     "unidade": "(Em reais de 2015)",
     "periodo": "1985/1989-2011",
     "ano": {
       "2011": "733.786.243"
     }
   },

...