Mudanças entre as edições de "API-PROJPOP"
(→Como recuperar dados do sistema PROJPOP através da API) |
|||
(21 edições intermediárias de 2 usuários não apresentadas) | |||
Linha 1: | Linha 1: | ||
= Apresentação = | = 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 projeções populacionais, em outros sítios ou a reutilização em sistemas desenvolvidos por usuários, mediante acesso direto à base de informações, sempre atualizada, do | + | 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 projeções populacionais, em outros sítios ou a reutilização em sistemas desenvolvidos por usuários, mediante acesso direto à base de informações, sempre atualizada, do Sistema Seade de Projeções Populacionais. O formato, em código aberto, é o JSON e não há necessidade de cadastro ou qualquer outro procedimento para o acesso. |
== URI == | == URI == | ||
Linha 13: | Linha 13: | ||
* '''Erro''': 404. | * '''Erro''': 404. | ||
− | = Como recuperar dados do sistema | + | = Como recuperar dados do sistema '''Projeções Populacionais''' através da API = |
<p>Para programar a recuperação de dados do sistema, devem ser levadas em conta as três dimensões / parâmetros que são passíveis de seleção: faixa-etaria; localidade; sexo; cod_localidade; ano. | <p>Para programar a recuperação de dados do sistema, devem ser levadas em conta as três dimensões / parâmetros que são passíveis de seleção: faixa-etaria; localidade; sexo; cod_localidade; ano. | ||
Caso a intenção seja recuperar todos os anos (dados) de uma dimensão / parâmetro ano , deve ser passado com all na sintaxe de comando. Ressalta-se que é indispensável a indicação de, todos os parâmetros exceto quando o parâmetro faixa-etaria for igaul 'IE'(Idade Escolar), nesse caso não é nescessário indicar o parâmetro sexo.</p> | Caso a intenção seja recuperar todos os anos (dados) de uma dimensão / parâmetro ano , deve ser passado com all na sintaxe de comando. Ressalta-se que é indispensável a indicação de, todos os parâmetros exceto quando o parâmetro faixa-etaria for igaul 'IE'(Idade Escolar), nesse caso não é nescessário indicar o parâmetro sexo.</p> | ||
− | |||
− | |||
<p>'''Sintaxe de chamada caso faixa-etaria seja igual a 'IQ'(Idade Quinquenal) ou 'SF'(Sem faixa etária):''' <br/> | <p>'''Sintaxe de chamada caso faixa-etaria seja igual a 'IQ'(Idade Quinquenal) ou 'SF'(Sem faixa etária):''' <br/> | ||
− | <nowiki>http://api-projpop.seade.gov.br/v1/dados/A/B/C/D/E</nowiki> | + | <nowiki>http://api-projpop.seade.gov.br/v1/dados/A/B/C/D/E</nowiki> <br/> |
'''onde A=faixa-etaria; B=localidade; C=sexo; D=cod_localidade; E=ano.'''.</p> | '''onde A=faixa-etaria; B=localidade; C=sexo; D=cod_localidade; E=ano.'''.</p> | ||
<br/> | <br/> | ||
<p>'''Sintaxe de chamada caso faixa-etaria seja igual a 'IE'(Idade Escolar):''' <br/> | <p>'''Sintaxe de chamada caso faixa-etaria seja igual a 'IE'(Idade Escolar):''' <br/> | ||
− | <nowiki>http://api-projpop.seade.gov.br/v1/dados/A/B/C/D/E</nowiki> | + | <nowiki>http://api-projpop.seade.gov.br/v1/dados/A/B/C/D/E</nowiki> <br/> |
'''onde A=faixa-etaria; B=localidade; C=cod_localidade; D=ano.'''.</p> | '''onde A=faixa-etaria; B=localidade; C=cod_localidade; D=ano.'''.</p> | ||
<br/> | <br/> | ||
− | <p>OBS: Caso o parâmetro B=localidade seja 'ESP'(Total Estado de SP), o parâmetro cod_localidade deve ser igual a 0, para se retornar todas as localidades das regiões, municípios, ras etc. Do estado de São Paulo.</p> | + | <p>'''OBS:''' Caso o parâmetro '''B=localidade seja 'ESP'(Total Estado de SP)''', '''o parâmetro cod_localidade deve ser igual a 0''', para se retornar todas as localidades das regiões, municípios, ras etc. Do estado de São Paulo.</p> |
= Recursos Disponíveis = | = Recursos Disponíveis = | ||
Linha 36: | Linha 34: | ||
== Dados == | == Dados == | ||
'''GET''' | '''GET''' | ||
− | + | ''' Caso parâmetro faixa-etaria igual a 'IQ'(Idade Quinquenal) ou 'SF'(Sem Faixa): | |
* '''Path''': /dados | * '''Path''': /dados | ||
− | * '''Parâmetros''': localidade/ | + | * '''Parâmetros''': faixa-etaria/localidade/sexo/cod-localidade/ano |
− | <nowiki>* É obrigatório a informação | + | <nowiki>* É obrigatório a informação todos os parâmetros.</nowiki> |
− | <nowiki>* Coloque | + | <nowiki>* Coloque all no parâmetro ano quando quiser trazer todos os anos.</nowiki> |
− | === Sintaxe de chamada === | + | === Sintaxe de chamada 'IQ'(Idade Quinquenal) ou 'SF'(Sem Faixa) === |
− | curl -X GET "http://api- | + | curl -X GET "http://api-projpop.seade.gov.br/v1/dados/iq/dc/t/80008/2016" |
ou | ou | ||
− | curl -X GET "http://api- | + | curl -X GET "http://api-projpop.seade.gov.br/v1/dados/iq/dc/t/80008/all" |
− | + | ||
=== Retorno JSON === | === Retorno JSON === | ||
Linha 59: | Linha 56: | ||
{ | { | ||
+ | |||
"dados": [ | "dados": [ | ||
{ | { | ||
− | " | + | "ano": "2016", |
− | " | + | "tipo_localizacao": "Distrito da Capital", |
− | " | + | "cod_distrito_capital": "80008", |
− | " | + | "nome": "Belém", |
− | " | + | "tipo_faixa_etaria": "idade quinquenal", |
− | " | + | "homes_00_a_04_anos": "2127", |
− | " | + | "homes_05_a_09_anos": "1444", |
− | " | + | "homes_10_a_14_anos": "1225", |
− | + | "homes_15_a_19_anos": "1284", | |
− | + | "homes_20_a_24_anos": "1407", | |
+ | "homes_25_a_29_anos": "1983", | ||
+ | "homes_30_a_34_anos": "2405", | ||
+ | "homes_35_a_39_anos": "2200", | ||
+ | "homes_40_a_44_anos": "1821", | ||
+ | "homes_45_a_49_anos": "1458", | ||
+ | "homes_50_a_54_anos": "1368", | ||
+ | "homes_55_a_59_anos": "1218", | ||
+ | "homes_60_a_64_anos": "1035", | ||
+ | "homes_65_a_69_anos": "735", | ||
+ | "homes_70_a_74_anos": "464", | ||
+ | "homes_75_anos_ou_mais": "814", | ||
+ | "mulheres_00_a_04_anos": "2037", | ||
+ | "mulheres_05_a_09_anos": "1403", | ||
+ | "mulheres_10_a_14_anos": "1208", | ||
+ | "mulheres_15_a_19_anos": "1313", | ||
+ | "mulheres_20_a_24_anos": "1358", | ||
+ | "mulheres_25_a_29_anos": "1803", | ||
+ | "mulheres_30_a_34_anos": "2208", | ||
+ | "mulheres_35_a_39_anos": "2136", | ||
+ | "mulheres_40_a_44_anos": "1741", | ||
+ | "mulheres_45_a_49_anos": "1527", | ||
+ | "mulheres_50_a_54_anos": "1561", | ||
+ | "mulheres_55_a_59_anos": "1437", | ||
+ | "mulheres_60_a_64_anos": "1323", | ||
+ | "mulheres_65_a_69_anos": "1047", | ||
+ | "mulheres_70_a_74_anos": "837", | ||
+ | "mulheres_75_anos_ou_mais": "1845", | ||
+ | "total_00_a_04_anos": "4164", | ||
+ | "total_05_a_09_anos": "2847", | ||
+ | "total_10_a_14_anos": "2433", | ||
+ | "total_15_a_19_anos": "2597", | ||
+ | "total_20_a_24_anos": "2765", | ||
+ | "total_25_a_29_anos": "3786", | ||
+ | "total_30_a_34_anos": "4613", | ||
+ | "total_35_a_39_anos": "4336", | ||
+ | "total_40_a_44_anos": "3562", | ||
+ | "total_45_a_49_anos": "2985", | ||
+ | "total_50_a_54_anos": "2929", | ||
+ | "total_55_a_59_anos": "2655", | ||
+ | "total_60_a_64_anos": "2358", | ||
+ | "total_65_a_69_anos": "1782", | ||
+ | "total_70_a_74_anos": "1301", | ||
+ | "total_75_anos_ou_mais": "2659", | ||
+ | "total_polpulacao_homem": "22988", | ||
+ | "total_polpulacao_mulher": "24784", | ||
+ | "total_geral_polpulacao": "47772" | ||
} | } | ||
] | ] | ||
− | |||
− | + | } | |
− | + | ||
+ | <br/><br/> | ||
+ | ''' Caso parâmetro faixa-etaria igual a 'IE'(Idade Escolar): | ||
− | * '''Path''': / | + | * '''Path''': /dados |
+ | * '''Parâmetros''': faixa-etaria/localidade/cod-localidade/ano | ||
− | * | + | <nowiki>* É obrigatório a informação todos os parâmetros.</nowiki> |
− | + | <nowiki>* Coloque all no parâmetro ano quando quiser trazer todos os anos.</nowiki> | |
+ | === Sintaxe de chamada 'IE'(Idade Escolar) === | ||
− | + | curl -X GET "http://api-projpop.seade.gov.br/v1/dados/ie/dc/80008/2016" | |
− | curl -X GET "http://api- | + | ou |
+ | |||
+ | curl -X GET "http://api-projpop.seade.gov.br/v1/dados/ie/dc/80008/all" | ||
+ | |||
+ | === Retorno JSON === | ||
+ | |||
+ | Exemplo: | ||
+ | { | ||
+ | |||
+ | "dados": [ | ||
+ | { | ||
+ | "ano": "2016", | ||
+ | "tipo_localizacao": "Distrito da Capital", | ||
+ | "cod_distrito_capital": "80008", | ||
+ | "nome": "Belém", | ||
+ | "tipo_faixa_etaria": "Idade Escolar", | ||
+ | "idade_escolar_00_a_03_anos": "3472", | ||
+ | "idade_escolar_04_a_05_anos": "1333", | ||
+ | "idade_escolar_06_anos": "597", | ||
+ | "idade_escolar_07_a_10_anos": "2105", | ||
+ | "idade_escolar_11_a_14_anos": "1937", | ||
+ | "idade_escolar_15_a_17_anos": "1545", | ||
+ | "idade_escolar_18_a_19_anos": "1052", | ||
+ | "total_idade_escolar": "12041", | ||
+ | "total_geral_polpulacao": "47772" | ||
+ | } | ||
+ | ] | ||
+ | |||
+ | } | ||
+ | |||
+ | |||
+ | <br/><br/> | ||
+ | ''' Caso parâmetro localidade igual a 'ESP'(Total Estado de SP): | ||
+ | |||
+ | * '''Path''': /dados | ||
+ | * '''Parâmetros''': faixa-etaria/localidade/cod-localidade/sexo/ano | ||
+ | |||
+ | <nowiki>* É obrigatório a informação todos os parâmetros.</nowiki> | ||
+ | |||
+ | <nowiki>* Coloque all no parâmetro ano quando quiser trazer todos os anos.</nowiki> | ||
+ | |||
+ | === Sintaxe de chamada 'ESP'(Total Estado de SP) === | ||
+ | |||
+ | curl -X GET "http://api-projpop.seade.gov.br/v1/dados/iq/esp/t/0/2016" | ||
ou | ou | ||
− | curl -X GET "http://api- | + | curl -X GET "http://api-projpop.seade.gov.br/v1/dados/iq/esp/t/0/all" |
+ | === Retorno JSON === | ||
+ | |||
+ | { | ||
+ | |||
+ | "dados": [ | ||
+ | { | ||
+ | "ano": "2016", | ||
+ | "tipo_localizacao": "Total Estado de SP", | ||
+ | "tipo_faixa_etaria": "idade quinquenal", | ||
+ | "homes_00_a_04_anos": "1494089", | ||
+ | "homes_05_a_09_anos": "1380962", | ||
+ | "homes_10_a_14_anos": "1434816", | ||
+ | "homes_15_a_19_anos": "1664121", | ||
+ | "homes_20_a_24_anos": "1752414", | ||
+ | "homes_25_a_29_anos": "1860847", | ||
+ | "homes_30_a_34_anos": "1874874", | ||
+ | "homes_35_a_39_anos": "1736913", | ||
+ | "homes_40_a_44_anos": "1545931", | ||
+ | "homes_45_a_49_anos": "1418896", | ||
+ | "homes_50_a_54_anos": "1279657", | ||
+ | "homes_55_a_59_anos": "1111017", | ||
+ | "homes_60_a_64_anos": "889397", | ||
+ | "homes_65_a_69_anos": "656994", | ||
+ | "homes_70_a_74_anos": "444094", | ||
+ | "homes_75_anos_ou_mais": "555461", | ||
+ | "mulheres_00_a_04_anos": "1424776", | ||
+ | "mulheres_05_a_09_anos": "1330012", | ||
+ | "mulheres_10_a_14_anos": "1383635", | ||
+ | "mulheres_15_a_19_anos": "1611938", | ||
+ | "mulheres_20_a_24_anos": "1701665", | ||
+ | "mulheres_25_a_29_anos": "1832405", | ||
+ | "mulheres_30_a_34_anos": "1910127", | ||
+ | "mulheres_35_a_39_anos": "1826009", | ||
+ | "mulheres_40_a_44_anos": "1651313", | ||
+ | "mulheres_45_a_49_anos": "1530797", | ||
+ | "mulheres_50_a_54_anos": "1430412", | ||
+ | "mulheres_55_a_59_anos": "1275808", | ||
+ | "mulheres_60_a_64_anos": "1050142", | ||
+ | "mulheres_65_a_69_anos": "813888", | ||
+ | "mulheres_70_a_74_anos": "585107", | ||
+ | "mulheres_75_anos_ou_mais": "900488", | ||
+ | "total_00_a_04_anos": "2918865", | ||
+ | "total_05_a_09_anos": "2710974", | ||
+ | "total_10_a_14_anos": "2818451", | ||
+ | "total_15_a_19_anos": "3276059", | ||
+ | "total_20_a_24_anos": "3454079", | ||
+ | "total_25_a_29_anos": "3693252", | ||
+ | "total_30_a_34_anos": "3785001", | ||
+ | "total_35_a_39_anos": "3562922", | ||
+ | "total_40_a_44_anos": "3197244", | ||
+ | "total_45_a_49_anos": "2949693", | ||
+ | "total_50_a_54_anos": "2710069", | ||
+ | "total_55_a_59_anos": "2386825", | ||
+ | "total_60_a_64_anos": "1939539", | ||
+ | "total_65_a_69_anos": "1470882", | ||
+ | "total_70_a_74_anos": "1029201", | ||
+ | "total_75_anos_ou_mais": "1455949", | ||
+ | "total_polpulacao_homem": "21100483", | ||
+ | "total_polpulacao_mulher": "22258522", | ||
+ | "total_geral_polpulacao": "43359005" | ||
+ | } | ||
+ | ] | ||
+ | |||
+ | } | ||
+ | |||
+ | == Tipos de Faixas Etárias == | ||
+ | '''GET''' | ||
+ | |||
+ | |||
+ | * '''Path''': /tipos-faixa-etaria | ||
+ | |||
+ | * '''Parâmetros''': nenhum | ||
+ | |||
+ | * Retorna todos os tipos de faixas etárias existentes | ||
+ | |||
+ | |||
+ | === Sintaxe de chamada === | ||
+ | |||
+ | curl -X GET "http://api-projpop.seade.gov.br/v1/tipos-faixa-etaria" | ||
=== Retorno JSON === | === Retorno JSON === | ||
Linha 100: | Linha 268: | ||
{ | { | ||
− | " | + | |
− | " | + | "tipos-faixa-etaria": { |
− | " | + | "IQ": "Idade Quinquenal", |
+ | "IE": "Idade Escolar", | ||
+ | "SF": "Sem Faixa Etária" | ||
} | } | ||
− | |||
+ | } | ||
− | == | + | == Tipos de Localidades == |
'''GET''' | '''GET''' | ||
− | * '''Path''': / | + | * '''Path''': /tipos-localidades |
− | * '''Parâmetros''': | + | * '''Parâmetros''': nenhum |
− | + | * Retorna todos os tipos de localidades existentes. | |
=== Sintaxe de chamada === | === Sintaxe de chamada === | ||
− | curl -X GET "http://api- | + | curl -X GET "http://api-projpop.seade.gov.br/v1/tipos-localidades" |
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
=== Retorno JSON === | === Retorno JSON === | ||
Linha 132: | Linha 297: | ||
{ | { | ||
− | " | + | |
− | " | + | "tipos-localidades": { |
− | " | + | "DC": "Distritos da Capital", |
− | " | + | "MUN": "Municípios", |
− | " | + | "RA": "Região administrativa", |
− | " | + | "RG": "Região de Governo", |
+ | "RM": "Região Metropolitana", | ||
+ | "DRS": "Departamento Regional de Saúde", | ||
+ | "ESP": "Total Estado de SP" | ||
} | } | ||
− | |||
+ | } | ||
− | == | + | == Localidade == |
'''GET''' | '''GET''' | ||
− | * '''Path''': / | + | * '''Path''': /localidade |
− | * '''Parâmetros''': | + | * '''Parâmetros''': tipo-localidade, cod-localidade |
− | Caso | + | Caso nescessário retornar todas as localidade daquele tipo deve se passar o parâmetro cod-localidade como 'ALL'. |
=== Sintaxe de chamada === | === Sintaxe de chamada === | ||
− | curl -X GET "http://api- | + | curl -X GET "http://api-projpop.seade.gov.br/v1/localidade/dc/{cod-localidade}" |
ou | ou | ||
− | curl -X GET "http://api- | + | curl -X GET "http://api-projpop.seade.gov.br/v1/localidade/dc/all" |
− | + | ||
=== Retorno JSON === | === Retorno JSON === | ||
Linha 167: | Linha 334: | ||
{ | { | ||
− | |||
− | |||
− | |||
− | |||
− | |||
− | == | + | "localidades": [ |
+ | { | ||
+ | "codigo": "80003", | ||
+ | "nome": "Anhanguera", | ||
+ | "tipo_localizacao": "Distrito da Capital" | ||
+ | } | ||
+ | ] | ||
+ | |||
+ | } | ||
+ | |||
+ | == Ano == | ||
'''GET''' | '''GET''' | ||
− | + | * '''Path''': /ano | |
+ | * '''Parâmetros''': nenhum | ||
+ | * Retorna todos os anos existentes na base. | ||
− | |||
− | |||
− | + | === Sintaxe de chamada === | |
− | + | curl -X GET "http://api-projpop.seade.gov.br/v1/ano" | |
+ | === Retorno JSON === | ||
− | + | Exemplo: | |
− | |||
− | + | { | |
− | + | "Anos": [ | |
+ | { | ||
+ | "ano": "2011" | ||
+ | }, | ||
+ | { | ||
+ | "ano": "2012" | ||
+ | }, | ||
+ | { | ||
+ | "ano": "2013" | ||
+ | }, | ||
+ | { | ||
+ | "ano": "2014" | ||
+ | }, | ||
+ | { | ||
+ | "ano": "2015" | ||
+ | }, | ||
+ | { | ||
+ | "ano": "2016" | ||
+ | }, | ||
+ | { | ||
+ | "ano": "2017" | ||
+ | }, | ||
+ | { | ||
+ | "ano": "2018" | ||
+ | }, | ||
+ | { | ||
+ | "ano": "2019" | ||
+ | }, | ||
+ | { | ||
+ | "ano": "2020" | ||
+ | }, | ||
+ | { | ||
+ | "ano": "2025" | ||
+ | }, | ||
+ | { | ||
+ | "ano": "2030" | ||
+ | } | ||
+ | ] | ||
+ | } | ||
+ | |||
+ | |||
+ | == Sexo == | ||
+ | '''GET''' | ||
+ | |||
+ | * '''Path''': /sexo | ||
+ | * '''Parâmetros''': nenhum | ||
+ | * Retorna todos os sexos existentes na base. | ||
+ | |||
+ | |||
+ | === Sintaxe de chamada === | ||
+ | |||
+ | curl -X GET "http://api-projpop.seade.gov.br/v1/sexo" | ||
=== Retorno JSON === | === Retorno JSON === | ||
Linha 201: | Linha 424: | ||
{ | { | ||
− | + | ||
− | + | "sexo": { | |
− | + | "H": "Homem", | |
− | + | "M": "Mulher", | |
− | + | "T": "Todos" | |
− | + | } | |
− | + | ||
− | + | } | |
− | + | ||
− | + | ||
− | + | ||
− | " | + | |
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + |
Edição atual tal como às 15h26min de 16 de outubro de 2017
Índice |
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 projeções populacionais, em outros sítios ou a reutilização em sistemas desenvolvidos por usuários, mediante acesso direto à base de informações, sempre atualizada, do Sistema Seade de Projeções Populacionais. 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-projpop.seade.gov.br/v1
Código HTTP de Retorno
- Sucesso: 200.
- Erro: 404.
Como recuperar dados do sistema Projeções Populacionais através da API
Para programar a recuperação de dados do sistema, devem ser levadas em conta as três dimensões / parâmetros que são passíveis de seleção: faixa-etaria; localidade; sexo; cod_localidade; ano. Caso a intenção seja recuperar todos os anos (dados) de uma dimensão / parâmetro ano , deve ser passado com all na sintaxe de comando. Ressalta-se que é indispensável a indicação de, todos os parâmetros exceto quando o parâmetro faixa-etaria for igaul 'IE'(Idade Escolar), nesse caso não é nescessário indicar o parâmetro sexo.
Sintaxe de chamada caso faixa-etaria seja igual a 'IQ'(Idade Quinquenal) ou 'SF'(Sem faixa etária):
http://api-projpop.seade.gov.br/v1/dados/A/B/C/D/E
onde A=faixa-etaria; B=localidade; C=sexo; D=cod_localidade; E=ano..
Sintaxe de chamada caso faixa-etaria seja igual a 'IE'(Idade Escolar):
http://api-projpop.seade.gov.br/v1/dados/A/B/C/D/E
onde A=faixa-etaria; B=localidade; C=cod_localidade; D=ano..
OBS: Caso o parâmetro B=localidade seja 'ESP'(Total Estado de SP), o parâmetro cod_localidade deve ser igual a 0, para se retornar todas as localidades das regiões, municípios, ras etc. Do estado de São Paulo.
Recursos Disponíveis
Dados
GET Caso parâmetro faixa-etaria igual a 'IQ'(Idade Quinquenal) ou 'SF'(Sem Faixa):
- Path: /dados
- Parâmetros: faixa-etaria/localidade/sexo/cod-localidade/ano
* É obrigatório a informação todos os parâmetros.
* Coloque all no parâmetro ano quando quiser trazer todos os anos.
Sintaxe de chamada 'IQ'(Idade Quinquenal) ou 'SF'(Sem Faixa)
curl -X GET "http://api-projpop.seade.gov.br/v1/dados/iq/dc/t/80008/2016"
ou
curl -X GET "http://api-projpop.seade.gov.br/v1/dados/iq/dc/t/80008/all"
Retorno JSON
Exemplo:
{
"dados": [ { "ano": "2016", "tipo_localizacao": "Distrito da Capital", "cod_distrito_capital": "80008", "nome": "Belém", "tipo_faixa_etaria": "idade quinquenal", "homes_00_a_04_anos": "2127", "homes_05_a_09_anos": "1444", "homes_10_a_14_anos": "1225", "homes_15_a_19_anos": "1284", "homes_20_a_24_anos": "1407", "homes_25_a_29_anos": "1983", "homes_30_a_34_anos": "2405", "homes_35_a_39_anos": "2200", "homes_40_a_44_anos": "1821", "homes_45_a_49_anos": "1458", "homes_50_a_54_anos": "1368", "homes_55_a_59_anos": "1218", "homes_60_a_64_anos": "1035", "homes_65_a_69_anos": "735", "homes_70_a_74_anos": "464", "homes_75_anos_ou_mais": "814", "mulheres_00_a_04_anos": "2037", "mulheres_05_a_09_anos": "1403", "mulheres_10_a_14_anos": "1208", "mulheres_15_a_19_anos": "1313", "mulheres_20_a_24_anos": "1358", "mulheres_25_a_29_anos": "1803", "mulheres_30_a_34_anos": "2208", "mulheres_35_a_39_anos": "2136", "mulheres_40_a_44_anos": "1741", "mulheres_45_a_49_anos": "1527", "mulheres_50_a_54_anos": "1561", "mulheres_55_a_59_anos": "1437", "mulheres_60_a_64_anos": "1323", "mulheres_65_a_69_anos": "1047", "mulheres_70_a_74_anos": "837", "mulheres_75_anos_ou_mais": "1845", "total_00_a_04_anos": "4164", "total_05_a_09_anos": "2847", "total_10_a_14_anos": "2433", "total_15_a_19_anos": "2597", "total_20_a_24_anos": "2765", "total_25_a_29_anos": "3786", "total_30_a_34_anos": "4613", "total_35_a_39_anos": "4336", "total_40_a_44_anos": "3562", "total_45_a_49_anos": "2985", "total_50_a_54_anos": "2929", "total_55_a_59_anos": "2655", "total_60_a_64_anos": "2358", "total_65_a_69_anos": "1782", "total_70_a_74_anos": "1301", "total_75_anos_ou_mais": "2659", "total_polpulacao_homem": "22988", "total_polpulacao_mulher": "24784", "total_geral_polpulacao": "47772" } ]
}
Caso parâmetro faixa-etaria igual a 'IE'(Idade Escolar):
- Path: /dados
- Parâmetros: faixa-etaria/localidade/cod-localidade/ano
* É obrigatório a informação todos os parâmetros.
* Coloque all no parâmetro ano quando quiser trazer todos os anos.
Sintaxe de chamada 'IE'(Idade Escolar)
curl -X GET "http://api-projpop.seade.gov.br/v1/dados/ie/dc/80008/2016"
ou
curl -X GET "http://api-projpop.seade.gov.br/v1/dados/ie/dc/80008/all"
Retorno JSON
Exemplo: {
"dados": [ { "ano": "2016", "tipo_localizacao": "Distrito da Capital", "cod_distrito_capital": "80008", "nome": "Belém", "tipo_faixa_etaria": "Idade Escolar", "idade_escolar_00_a_03_anos": "3472", "idade_escolar_04_a_05_anos": "1333", "idade_escolar_06_anos": "597", "idade_escolar_07_a_10_anos": "2105", "idade_escolar_11_a_14_anos": "1937", "idade_escolar_15_a_17_anos": "1545", "idade_escolar_18_a_19_anos": "1052", "total_idade_escolar": "12041", "total_geral_polpulacao": "47772" } ]
}
Caso parâmetro localidade igual a 'ESP'(Total Estado de SP):
- Path: /dados
- Parâmetros: faixa-etaria/localidade/cod-localidade/sexo/ano
* É obrigatório a informação todos os parâmetros.
* Coloque all no parâmetro ano quando quiser trazer todos os anos.
Sintaxe de chamada 'ESP'(Total Estado de SP)
curl -X GET "http://api-projpop.seade.gov.br/v1/dados/iq/esp/t/0/2016"
ou
curl -X GET "http://api-projpop.seade.gov.br/v1/dados/iq/esp/t/0/all"
Retorno JSON
{
"dados": [ { "ano": "2016", "tipo_localizacao": "Total Estado de SP", "tipo_faixa_etaria": "idade quinquenal", "homes_00_a_04_anos": "1494089", "homes_05_a_09_anos": "1380962", "homes_10_a_14_anos": "1434816", "homes_15_a_19_anos": "1664121", "homes_20_a_24_anos": "1752414", "homes_25_a_29_anos": "1860847", "homes_30_a_34_anos": "1874874", "homes_35_a_39_anos": "1736913", "homes_40_a_44_anos": "1545931", "homes_45_a_49_anos": "1418896", "homes_50_a_54_anos": "1279657", "homes_55_a_59_anos": "1111017", "homes_60_a_64_anos": "889397", "homes_65_a_69_anos": "656994", "homes_70_a_74_anos": "444094", "homes_75_anos_ou_mais": "555461", "mulheres_00_a_04_anos": "1424776", "mulheres_05_a_09_anos": "1330012", "mulheres_10_a_14_anos": "1383635", "mulheres_15_a_19_anos": "1611938", "mulheres_20_a_24_anos": "1701665", "mulheres_25_a_29_anos": "1832405", "mulheres_30_a_34_anos": "1910127", "mulheres_35_a_39_anos": "1826009", "mulheres_40_a_44_anos": "1651313", "mulheres_45_a_49_anos": "1530797", "mulheres_50_a_54_anos": "1430412", "mulheres_55_a_59_anos": "1275808", "mulheres_60_a_64_anos": "1050142", "mulheres_65_a_69_anos": "813888", "mulheres_70_a_74_anos": "585107", "mulheres_75_anos_ou_mais": "900488", "total_00_a_04_anos": "2918865", "total_05_a_09_anos": "2710974", "total_10_a_14_anos": "2818451", "total_15_a_19_anos": "3276059", "total_20_a_24_anos": "3454079", "total_25_a_29_anos": "3693252", "total_30_a_34_anos": "3785001", "total_35_a_39_anos": "3562922", "total_40_a_44_anos": "3197244", "total_45_a_49_anos": "2949693", "total_50_a_54_anos": "2710069", "total_55_a_59_anos": "2386825", "total_60_a_64_anos": "1939539", "total_65_a_69_anos": "1470882", "total_70_a_74_anos": "1029201", "total_75_anos_ou_mais": "1455949", "total_polpulacao_homem": "21100483", "total_polpulacao_mulher": "22258522", "total_geral_polpulacao": "43359005" } ]
}
Tipos de Faixas Etárias
GET
- Path: /tipos-faixa-etaria
- Parâmetros: nenhum
- Retorna todos os tipos de faixas etárias existentes
Sintaxe de chamada
curl -X GET "http://api-projpop.seade.gov.br/v1/tipos-faixa-etaria"
Retorno JSON
Exemplo:
{
"tipos-faixa-etaria": { "IQ": "Idade Quinquenal", "IE": "Idade Escolar", "SF": "Sem Faixa Etária" }
}
Tipos de Localidades
GET
- Path: /tipos-localidades
- Parâmetros: nenhum
- Retorna todos os tipos de localidades existentes.
Sintaxe de chamada
curl -X GET "http://api-projpop.seade.gov.br/v1/tipos-localidades"
Retorno JSON
Exemplo:
{
"tipos-localidades": { "DC": "Distritos da Capital", "MUN": "Municípios", "RA": "Região administrativa", "RG": "Região de Governo", "RM": "Região Metropolitana", "DRS": "Departamento Regional de Saúde", "ESP": "Total Estado de SP" }
}
Localidade
GET
- Path: /localidade
- Parâmetros: tipo-localidade, cod-localidade
Caso nescessário retornar todas as localidade daquele tipo deve se passar o parâmetro cod-localidade como 'ALL'.
Sintaxe de chamada
curl -X GET "http://api-projpop.seade.gov.br/v1/localidade/dc/{cod-localidade}"
ou
curl -X GET "http://api-projpop.seade.gov.br/v1/localidade/dc/all"
Retorno JSON
Exemplo:
{
"localidades": [ { "codigo": "80003", "nome": "Anhanguera", "tipo_localizacao": "Distrito da Capital" } ]
}
Ano
GET
- Path: /ano
- Parâmetros: nenhum
- Retorna todos os anos existentes na base.
Sintaxe de chamada
curl -X GET "http://api-projpop.seade.gov.br/v1/ano"
Retorno JSON
Exemplo:
{
"Anos": [ { "ano": "2011" }, { "ano": "2012" }, { "ano": "2013" }, { "ano": "2014" }, { "ano": "2015" }, { "ano": "2016" }, { "ano": "2017" }, { "ano": "2018" }, { "ano": "2019" }, { "ano": "2020" }, { "ano": "2025" }, { "ano": "2030" } ]
}
Sexo
GET
- Path: /sexo
- Parâmetros: nenhum
- Retorna todos os sexos existentes na base.
Sintaxe de chamada
curl -X GET "http://api-projpop.seade.gov.br/v1/sexo"
Retorno JSON
Exemplo:
{
"sexo": { "H": "Homem", "M": "Mulher", "T": "Todos" }
}