{"id":20337987,"url":"https://github.com/apibrasil/api-multas","last_synced_at":"2025-04-11T22:52:55.975Z","repository":{"id":194916220,"uuid":"691830520","full_name":"APIBrasil/api-multas","owner":"APIBrasil","description":"Projeto open source para buscar multas e retornar um JSON, via API Rest","archived":false,"fork":false,"pushed_at":"2024-04-03T12:42:41.000Z","size":689,"stargazers_count":37,"open_issues_count":1,"forks_count":7,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-04-11T22:52:46.722Z","etag":null,"topics":["api-placa","detram-multas","detran","detran-mg","multas","placa"],"latest_commit_sha":null,"homepage":"https://apibrasil.io","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/APIBrasil.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null},"funding":{"github":null,"patreon":null,"open_collective":null,"ko_fi":null,"tidelift":null,"community_bridge":null,"liberapay":null,"issuehunt":"jhowbhz","otechie":null,"lfx_crowdfunding":null,"custom":null}},"created_at":"2023-09-15T01:37:34.000Z","updated_at":"2025-02-19T11:52:23.000Z","dependencies_parsed_at":"2024-11-14T21:11:13.505Z","dependency_job_id":"f9b41bb8-c343-43db-8e67-55c3eb433b21","html_url":"https://github.com/APIBrasil/api-multas","commit_stats":null,"previous_names":["apibrasil/api-multas"],"tags_count":2,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/APIBrasil%2Fapi-multas","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/APIBrasil%2Fapi-multas/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/APIBrasil%2Fapi-multas/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/APIBrasil%2Fapi-multas/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/APIBrasil","download_url":"https://codeload.github.com/APIBrasil/api-multas/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248492956,"owners_count":21113162,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["api-placa","detram-multas","detran","detran-mg","multas","placa"],"created_at":"2024-11-14T21:11:07.499Z","updated_at":"2025-04-11T22:52:55.956Z","avatar_url":"https://github.com/APIBrasil.png","language":"TypeScript","funding_links":["https://issuehunt.io/r/jhowbhz"],"categories":[],"sub_categories":[],"readme":"# 💵 API de Multas Brasil \nA ideia desse repositório é centralizar e obter dados de Multas de todos os Detrans, através da técnica de Web Scraping e retornar os dados das multas em JSON\n\n## Status do Scrap\nVocê pode acompanhar o status de cada scrap no link abaixo\n\n\u003ca href=\"https://status.apibrasil.com.br/status/whatsapp\"\u003e https://status.apibrasil.com.br \u003c/a\u003e\n\n## Consumindo com Javascript\n```bash\nyarn add api-multas\n```\n\n```ts\nimport ApiMultas from 'api-multas'\n\n(async () =\u003e {\n\n    const host = 'http://localhost:2222'; // seu localhost\n    const token = '1234567890'; // você deve criar qualquer token\n\n    const api = new ApiMultas();\n\n    const request = await api.multas('mg', host, token, {\n        placa: 'ABC1234',\n        renavam: '123456789'\n    });\n\n    console.log(request);\n\n})();\n```\n\n## Alguns detalhes específicos por estado\nObservações para o estado de PI, PA que por ter captcha é necessário obter uma chave do \u003ca href=\"2captcha.com\" target=\"_blank\" \u003e 2captcha \u003c/a\u003e\n\n```ts\nimport ApiMultas from 'api-multas'\n\n(async () =\u003e {\n\n    const host = 'http://localhost:2222';\n    const token = '1234567890';\n\n    const api = new ApiMultas();\n\n    //use o webhook.site para visualizar o retorno\n    const request = await api.multas('mg', host, token, {\n        placa: \"ABC1234\",\n        renavam: \"0000000000\",\n        twocaptchaapikey: \"abc1234abc1234abc1234abc1234\",\n        webhook: \"https://webhook.site/3545dc20-14ff-4c74-bee0-755762fd834a\"\n    });\n\n    console.log(request);\n\n})();\n```\n\nLink do pacote\n\u003ca href=\"https://www.npmjs.com/package/api-multas\" target=\"_blank\"\u003e https://www.npmjs.com/package/api-multas \u003c/a\u003e\n\n## Estados suportados\nAinda não suportamos todos os estados, em breve  iremos adicionar mais estados, se quiser sugerir um estado, abra uma PR\n\n|    DETRAN    |   SITUAÇÃO        |   DISPONIBILIDADE    |    OBSERVAÇÕES                         |\n|---------------|-------------------|----------------------|----------------------------------------\n|    Detran MG\t|\tDISPONÍVEL      |    Operacional       |                                       |\n|    Detran AL\t|\tDISPONÍVEL      |    Operacional       |                                       |\n|    Detran PB\t|\tDISPONÍVEL      |    Operacional       |                                       |\n|    Detran GO\t|\tDISPONÍVEL      |    Operacional       |                                       |\n|    Detran MA\t|   DISPONÍVEL      |    Operacional       |                                       |\n|    Detran DF\t|   DISPONÍVEL      |    Operacional       |                                       |\n|    Detran MS\t|\tDISPONÍVEL      |    Operacional       |                                       |\n|    Detran PE\t|   DISPONÍVEL      |    Operacional       |                                       |\n|    Detran SE\t|   DISPONÍVEL      |    Operacional       |                                       |\n|    Detran PR\t|   DISPONÍVEL      |    Operacional       |                                       |\n|    Detran PI\t|   DISPONÍVEL      |    Operacional       | Necessário informar 2Captcha/Webhook  |\n|    Detran PA\t|   DISPONÍVEL      |    Operacional       | Necessário informar 2Captcha/Webhook  |\n|    Detran SC\t|   DISPONÍVEL      |    Operacional       | Necessário informar 2Captcha          |\n|    Detran AC\t|Em desenvolvimento |                      |                                       |\n|    Detran AM\t|Em desenvolvimento |                      |                                       |\n|    Detran BA\t|Em desenvolvimento |                      |                                       |\n|    Detran CE\t|Em desenvolvimento |                      |                                       |\n|    Detran ES\t|Em desenvolvimento |                      |                                       |\n|    Detran MT\t|Em desenvolvimento |                      |                                       |\n|    Detran RJ\t|Em desenvolvimento |                      |                                       |\n|    Detran RN\t|Em desenvolvimento |                      |                                       |\n|    Detran RO\t|Em desenvolvimento |                      |                                       |\n|    Detran RR\t|Em desenvolvimento |                      |                                       |\n|    Detran RS\t|Em desenvolvimento |                      |                                       |\n|    Detran SP\t|Em desenvolvimento |                      |                                       |\n|    Detran TO  |Em desenvolvimento |                      |                                       |\n\n## Dependencias (Linux)\n```bash\napt update -y \u0026\u0026 apt upgrade -y \u0026\u0026 apt install git curl -y \n```\n\n## Instalando Node 18 (Linux)\n```bash\ncurl https://raw.githubusercontent.com/creationix/nvm/master/install.sh | bash  \u0026\u0026 source ~/.profile  \u0026\u0026 nvm install 18 \u0026\u0026 nvm use 18\n```\n\n## Instalando Yarn (Linux)\n```bash\ncurl -sS https://dl.yarnpkg.com/debian/pubkey.gpg | sudo apt-key add - \u0026\u0026 echo \"deb https://dl.yarnpkg.com/debian/ stable main\" | sudo tee /etc/apt/sources.list.d/yarn.list \u0026\u0026 sudo apt update -y \u0026\u0026 sudo apt install yarn -y \u0026\u0026 yarn global add pm2\n```\n\n## Instalando Node e Yarn (Windows)\nVocê irá precisar do Node 18+ para utilizar essa API\n\n#### Dowload Yarn\nhttps://classic.yarnpkg.com/lang/en/docs/install/#windows-stable\n\n#### Download Node\nhttps://nodejs.org/pt-br/download\n\n## Instalação API (Linux)\n```bash \ncd /opt/\n```\n\n```bash\ngit clone https://github.com/APIBrasil/api-multas.git \u0026\u0026 cd /api-multas\n```\n\n```bash\ncp .env-exemplo .env \u0026\u0026 yarn \u0026\u0026 yarn start\n```\n\n## Rodando em Background\n```bash\nyarn add pm2 --global\n```\n\n```bash\npm2 start dist/index.js --name=API-MULTAS\n```\n\n## Exemplos de requests e respostas\n```\n[POST] https://localhost:2222/multas/mg\n```\n```\n[POST] https://localhost:2222/multas/al\n```\n## Payloads de request padrão \nO payload pode variar de acordo com o estado.\n```json\n{ \n    \"placa\":\"ABC1234\",\n    \"renavam\":\"00000000000\"\n}\n```\n\n## Response da request padrão\nO response pode variar de acordo com o estado.\n```json\n{\n    \"placa\": \"ABC1234\",\n    \"renavam\": \"00000000000\",\n    \"multas\": [\n        {\n            \"sequencia\": \"1\",\n            \"processo\": \"00000000\",\n            \"descricao\": \"TRANSITAR EM VELOCIDADE SUPERIOR A MAXIMA PERMITIDA EM ATE 2\",\n            \"local\": \"AV. RISOLETA NEVES  A 138M DA RUA RAIMUNDA FERREIR\",\n            \"valor\": 152.11\n        },\n        {\n            \"sequencia\": \"2\",\n            \"processo\": \"00000000\",\n            \"descricao\": \"DIRIGIR VEICULO SEGURANDO TELEFONE CELULAR\",\n            \"local\": \"AVE AFONSO SILVA ESQUINA RUA ESPIRITO DE LUZ\",\n            \"valor\": 299.54\n        }\n    ]\n}\n```\n\n## Observações importantes\n⚠️ 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. \n\n## License\n\nMIT © [APIBrasil](http://jhowbhz.com)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fapibrasil%2Fapi-multas","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fapibrasil%2Fapi-multas","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fapibrasil%2Fapi-multas/lists"}