Skip to content
/ api-multas-npm Public template

A ideia desse repositório é obter dados de Multas de todos os Detrans, através de Web Scrap e retornar os dados das multas em JSON

License

Notifications You must be signed in to change notification settings

APIBrasil/api-multas-npm

Repository files navigation

💵 API de Multas Brasil

A ideia desse repositório é obter dados de Multas de todos os Detrans, através de Web Scrap e retornar os dados das multas em JSON

Estados suportados

Ainda não suportamos todos os estados, em breve iremos adicionar mais estados, se quiser sugerir um estado, abra uma PR

Servidor Back-end

Você irá precisar subir um servidor Backend para consumir esse pacote

https://github.com/APIBrasil/api-multas

Ou de um servidor de API

https://apibrasil.io

Estados suportados

Ainda não suportamos todos os estados, em breve iremos adicionar mais estados, se quiser sugerir um estado, abra uma PR

DETRAN SITUAÇÃO DISPONIBILIDADE OBSERVAÇÕES
Detran MG DISPONÍVEL Operacional
Detran AL DISPONÍVEL Operacional
Detran PB DISPONÍVEL Operacional
Detran GO DISPONÍVEL Operacional
Detran MA DISPONÍVEL Operacional
Detran DF DISPONÍVEL Operacional
Detran MS DISPONÍVEL Operacional
Detran PE DISPONÍVEL Operacional
Detran SE DISPONÍVEL Operacional
Detran PR DISPONÍVEL Operacional
Detran PI DISPONÍVEL Operacional Necessário informar webhook
Detran PA DISPONÍVEL Operacional Necessário informar webhook
Detran AC Em desenvolvimento
Detran AM Em desenvolvimento
Detran BA Em desenvolvimento
Detran CE Em desenvolvimento
Detran ES Em desenvolvimento
Detran MT Em desenvolvimento
Detran RJ Em desenvolvimento
Detran RN Em desenvolvimento
Detran RO Em desenvolvimento
Detran RR Em desenvolvimento
Detran RS Em desenvolvimento
Detran SC Em desenvolvimento
Detran SP Em desenvolvimento
Detran TO Em desenvolvimento

Como instalar usando npm

npm i api-multas

Como instalar usando yarn

yarn add api-multas

Como consumir com TypeScript

import ApiMultas from 'api-multas'

(async () => {

    const host = 'http://localhost:2222';
    const token = '1234567890';

    const api = new ApiMultas();

    const request = await api.multas('mg', host, token, {
        placa: 'ABC1234',
        renavam: '0000000000'
    });

    console.log(request);

})();

Oservações para o estado de PI, que por ter captcha é necessário obter uma chave do 2captcha

import ApiMultas from 'api-multas'

(async () => {

    const host = 'http://localhost:2222';
    const token = '1234567890';

    const api = new ApiMultas();

    //use o webhook.site para visualizar o retorno
    const request = await api.multas('mg', host, token, {
        placa: "ABC1234",
        renavam: "0000000000",
        twocaptchaapikey: "abc1234abc1234abc1234abc1234",
        webhook: "https://webhook.site/3545dc20-14ff-4c74-bee0-755762fd834a"
    });

    console.log(request);

})();

Possiveis respostas

{
    "placa": "ABC1234",
    "renavam": "00000000000",
    "multas": [
        {
            "sequencia": "1",
            "processo": "00000000",
            "descricao": "TRANSITAR EM VELOCIDADE SUPERIOR A MAXIMA PERMITIDA EM ATE 2",
            "local": "AV. RISOLETA NEVES  A 138M DA RUA RAIMUNDA FERREIR",
            "valor": 152.11
        },
        {
            "sequencia": "2",
            "processo": "00000000",
            "descricao": "DIRIGIR VEICULO SEGURANDO TELEFONE CELULAR",
            "local": "AVE AFONSO SILVA ESQUINA RUA ESPIRITO DE LUZ",
            "valor": 299.54
        }
    ]
}

Observações

⚠️ Essa API é apenas parte de um estudo pessoal, use em produção por sua conta e risco, lembre-se essa API se basea em técnicas de web scrap para obter os dados em transformar em JSON, se o DETRAN do seu estado alterar algo nos avise para que possamos corrgir.

About

A ideia desse repositório é obter dados de Multas de todos os Detrans, através de Web Scrap e retornar os dados das multas em JSON

Topics

Resources

License

Stars

Watchers

Forks

Sponsor this project

Packages

No packages published