Consultas FIPE pela placa do veículo.
Project description
PlacaFipy
PlacaFipy é uma biblioteca Python que permite realizar consultas FIPE pela placa do veículo.
Funcionalidades
obter_estado(sigla)
: Retorna o estado a partir da sigla.verificar_placa_mercosul(placa)
: Verifica se uma placa é do modelo Mercosul.converter_placa(placa)
: Converte a placa informada para o padrão Mercosul ou vice-versa.consulta(placa)
: Consulta informações de um veículo pela placa.
Obtenha um API Token em ScrapingAnt
Para usar o PlacaFipy, é necessário um token de API do ScrapingAnt para contornar verificações anti-webscraping.
O ScrapingAnt fornece 1.000 consultas gratuitas por mês.
Você pode criar uma conta em ScrapingAnt e obter seu token API lá.
Instalação
Você pode instalar este pacote via pip:
pip install placafipy
Como utilizar
from placafipy import PlacaFipy
# Crie uma instância do PlacaFipy passando uma lista com os tokens do ScrapingAnt como parâmetros. Você pode adicionar quantos tokens forem necessários.
tokens = ["SEU_TOKEN_1", "SEU_TOKEN_2", "SEU_TOKEN_3"]
placafipy = PlacaFipy(tokens)
# Obter o estado a partir da sigla
estado = placafipy.obter_estado('PE')
print(estado) # Saída: PERNAMBUCO
# Verificar se uma placa é do modelo Mercosul
placa_mercosul = placafipy.verificar_placa_mercosul('ABC1C34')
print(placa_mercosul) # Saída: True
# Conversão de placas
placa_convertida = placafipy.converter_placa('ABC1234')
print(placa_convertida) # Saída: ABC1C34
placa_convertida = placafipy.converter_placa('ABC1C34')
print(placa_convertida) # Saída: ABC1234
# Consultar informações de um veículo pela placa
placa = "ABC1234"
informacoes_veiculo = placafipy.consulta(placa)
if informacoes:
print(informacoes)
else:
print("Não foi possível obter informações para a placa especificada.")
Exemplo de Saída
{
"tabela_fipe": {
"valores": {...},
"valores_ipva": {...}
},
"detalhes": {...},
"imagem_logo_url": "https://example.com/logo.png",
"imagem_placa_url": "https://example.com/placa.png",
"orgao_emissor": "DETRAN",
"veiculos_registrados": 10000,
"tipo_veiculo": "carro",
...
}
Nota: A saída é obtida de forma dinâmica, portanto, alguns resultados podem conter diferentes chaves dependendo dos dados disponíveis no momento da consulta.
Contribuição
Contribuições são bem-vindas! Sinta-se à vontade para abrir uma issue ou enviar um pull request.
Autor
Licença
Este pacote está sob a licença MIT.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for PlacaFipy-1.0.3-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 159c558879478788b2801328ad0ceca9f90fd2e519a2ddff8dbe37a578366d50 |
|
MD5 | 8691cf74888217ec151890c8836187be |
|
BLAKE2b-256 | a069bae439f866dfd2e405ce49dcbc1c18a683b3f6c4471af592408e101a461a |