Mudanças entre as edições de "API-GOVERNO-ABERTO-SP"
| Linha 1: | Linha 1: | ||
| − | '''Governo Aberto SP API''' | + | '''Governo Aberto SP - REST API''' |
| + | Acesse informações sobre os conjuntos de dados e seus recursos através de uma API poderosa. | ||
| − | |||
| − | + | Uma forma de acessar as informações do Portal Governo Aberto SP é mediante o sistema REST API. As informações obtidas podem ser utilizadas com um código externo para consultar a API do portal. | |
| − | + | ||
| − | + | ||
| − | + | ||
| − | Uma forma de acessar as informações do Portal Governo Aberto SP é mediante o sistema REST | + | |
| Linha 13: | Linha 9: | ||
| − | O | + | O Governo Aberto SP baseia-se numa aplicação de CKAN, cujo site contém documentação completa sobre a API. Mais informações consulte a documentação principal da [<a href="http://docs.ckan.org/en/latest/api/">CKAN Data API</a>]. |
| Linha 19: | Linha 15: | ||
| − | Ferramentas para utilizar o sistema REST API | + | '''Ferramentas para utilizar o sistema REST API''' |
| − | Clientes http e bibliotecas | + | '''Clientes http e bibliotecas''' |
curl é uma ferramenta de linha de comandos http genérica que pode ser utilizada para interrogar a API. Consulte os exemplos abaixo para ver como pode ser utilizada. | curl é uma ferramenta de linha de comandos http genérica que pode ser utilizada para interrogar a API. Consulte os exemplos abaixo para ver como pode ser utilizada. | ||
| + | |||
Existem extensões para os navegadores mais utilizados que permitem fazer consultas à API no próprio navegador como, por exemplo Postman para Google Chrome ou RESTClient para Mozilla Firefox. | Existem extensões para os navegadores mais utilizados que permitem fazer consultas à API no próprio navegador como, por exemplo Postman para Google Chrome ou RESTClient para Mozilla Firefox. | ||
| + | |||
A maioria das linguagens de programação pode ser utilizada para fazer uma consulta à API, desde que exista uma componente de conexão http compatível, como é o caso de Jersey para Java. | A maioria das linguagens de programação pode ser utilizada para fazer uma consulta à API, desde que exista uma componente de conexão http compatível, como é o caso de Jersey para Java. | ||
| − | Ferramentas especializadas | + | |
| + | '''Ferramentas especializadas''' | ||
Foram desenvolvidas algumas ferramentas especializadas, que podem ser utilizadas para facilitar a utilização do sistema REST API: | Foram desenvolvidas algumas ferramentas especializadas, que podem ser utilizadas para facilitar a utilização do sistema REST API: | ||
| Linha 51: | Linha 50: | ||
'''Obter uma lista de conjuntos de dados em JSON''' | '''Obter uma lista de conjuntos de dados em JSON''' | ||
| + | |||
curl http://catalogo.governoaberto.sp.gov.br/api/3/action/package_list -d'{}' | curl http://catalogo.governoaberto.sp.gov.br/api/3/action/package_list -d'{}' | ||
Edição das 15h20min de 6 de dezembro de 2016
Governo Aberto SP - REST API Acesse informações sobre os conjuntos de dados e seus recursos através de uma API poderosa.
Uma forma de acessar as informações do Portal Governo Aberto SP é mediante o sistema REST API. As informações obtidas podem ser utilizadas com um código externo para consultar a API do portal.
Para as atividades de programação, a API está disponível na seguinte URL: http:// http://catalogo.governoaberto.sp.gov.br/api/3/
O Governo Aberto SP baseia-se numa aplicação de CKAN, cujo site contém documentação completa sobre a API. Mais informações consulte a documentação principal da [<a href="http://docs.ckan.org/en/latest/api/">CKAN Data API</a>].
O formato das mensagens para o corpo quer dos pedidos quer das respostas é o JSON (especificado em RFC 4627). Seguem-se alguns exemplos de utilização do sistema REST API na sua aplicação.
Ferramentas para utilizar o sistema REST API
Clientes http e bibliotecas
curl é uma ferramenta de linha de comandos http genérica que pode ser utilizada para interrogar a API. Consulte os exemplos abaixo para ver como pode ser utilizada.
Existem extensões para os navegadores mais utilizados que permitem fazer consultas à API no próprio navegador como, por exemplo Postman para Google Chrome ou RESTClient para Mozilla Firefox.
A maioria das linguagens de programação pode ser utilizada para fazer uma consulta à API, desde que exista uma componente de conexão http compatível, como é o caso de Jersey para Java.
Ferramentas especializadas
Foram desenvolvidas algumas ferramentas especializadas, que podem ser utilizadas para facilitar a utilização do sistema REST API:
Python ckanclient — CKAN Python Client (o cliente oficial gerido pela equipa de CKAN, em Python)
Java Ckan_client-J
Ruby CKAN Ruby
Javascript ckanjs
PHP Ckan_client-PHP
Exemplos de consultas
Obter uma lista de conjuntos de dados em JSON
curl http://catalogo.governoaberto.sp.gov.br/api/3/action/package_list -d'{}'
Obter uma lista de etiquetas em JSON
curl http://catalogo.governoaberto.sp.gov.br/api/3/action/tag_list -d'{}'
Obter a descrição de um determinado conjunto de dados em JSON
curl http://catalogo.governoaberto.sp.gov.br/api/3/action/package_show -d'{"id": "dgt-translation-memory"}'
Procurar conjuntos de dados ou recursos que correspondem a uma consulta
curl http://catalogo.governoaberto.sp.gov.br/api/3/action/package_search -d'{"q": "forest"}'
