Skip to main content

Simples wrapper para API de licitações da Prefeitura de São Paulo

Project description

sp_licitacoesPy

Simples wrapper, em desenvolvimento, para API de licitações da Prefeitura de São Paulo

Este pacote foi feito para que não seja mais nescessário montar uma requisição manual (usando urrlib ou requests, por exemplo) para API. Agora basta algumas linhas de código:

from sp_licitacoesPy import licitacoes
token = '------------' # Seu token aqui!

# Retorna uma lista com 35 licitações do ano de 2009.
dados = licitacoes.obter_dados(token, ano = 2009, quantidade = 35)

Instalação

Para instalar, basta usar o PyPi:

você@máquina:$ pip install sp_licitacoesPy

Agora, é nescessário criar uma conta na Vitrine de APIs da Cidade de São Paulo. É preciso se inscrever na API Licitacoes - v1, e então gerar um token dentro de Applications na Default Application na aba Production Keys, onde aparecerá um botão de gerar um Access Token.

Este token é necessário na verificação da solicitação para a API. Sem ele o pacote não funciona :/

Note que o Access Token gerado tem um tempo limite de 3600 segundos!

Uso

Todas as funções nescessárias estão dentro de um único arquivo licitacoes.py dentro do pacote. São duas as funções mais importantes:

  • resposta_json()

    • Esta função constrói um URL para solicitação à API, e retorna a resposta JSON em um dicionário.
  • obter_dados()

    • Esta função que "limpa" a resposta JSON da API, e retorna uma lista de dicionários com as licitações.

Parâmetros para ambas as funções:

token ano = 2008 quantidade = 1 offset = 0
obrigatório opcional opcional opcional
str int int int
deve ser válido 2008<= ano <= 2019 < 10.000 < 10.000

Note que o valor quatidade + offset também não pode ser superior ao de 10.000

  • token: é aquele gerado pela próptia Vitirine de APIs. Se este não for válido, resultará em um erro "Token_Invalido"

  • ano: o ano da(s) licitação(ões) desejada(s), este deve estar entre 2008 e 2019. O valor padrão é o ano de 2008.

  • quantidade: a quatidade de licitações desejadas, que não deve ultrapassar 10.000. O valor padrão é de 1 (uma licitação apenas).

  • offset: se refere a paginação da base de dados das licitações, este não deve ultrapassar o valor de 10.000. O valor padrão é de 0.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

sp_licitacoesPy-0.0.2.tar.gz (5.0 kB view hashes)

Uploaded Source

Built Distribution

sp_licitacoesPy-0.0.2-py3-none-any.whl (6.5 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page