💵 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.