{"id":27294385,"url":"https://github.com/ivanildobarauna-dev/apibrasil-py","last_synced_at":"2025-08-03T22:34:37.117Z","repository":{"id":170751681,"uuid":"646985900","full_name":"ivanildobarauna-dev/apibrasil-py","owner":"ivanildobarauna-dev","description":"Este SDK foi desenvolvido para simplificar e agilizar a integração com a plataforma APIBrasil, reduzindo o esforço de desenvolvimento e otimizando o tempo dos usuários.","archived":false,"fork":false,"pushed_at":"2024-12-10T03:41:42.000Z","size":199,"stargazers_count":6,"open_issues_count":1,"forks_count":4,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-07-25T03:47:50.745Z","etag":null,"topics":["apibrasil","apigratis","pip","portfolio-display","python3","sdk-python","whatsapp"],"latest_commit_sha":null,"homepage":"https://pypi.org/project/api-brasil/","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ivanildobarauna-dev.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE","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,"zenodo":null},"funding":{"github":["jhowbhz","IvanildoBarauna"],"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-05-29T20:01:17.000Z","updated_at":"2025-07-22T18:26:22.000Z","dependencies_parsed_at":null,"dependency_job_id":"538abfcb-2640-4fcf-9d87-2c504e5a8d8d","html_url":"https://github.com/ivanildobarauna-dev/apibrasil-py","commit_stats":null,"previous_names":["apibrasil/apigratis-sdk-python","ivanildobarauna-dev/apigratis-sdk-python"],"tags_count":9,"template":false,"template_full_name":null,"purl":"pkg:github/ivanildobarauna-dev/apibrasil-py","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ivanildobarauna-dev%2Fapibrasil-py","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ivanildobarauna-dev%2Fapibrasil-py/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ivanildobarauna-dev%2Fapibrasil-py/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ivanildobarauna-dev%2Fapibrasil-py/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ivanildobarauna-dev","download_url":"https://codeload.github.com/ivanildobarauna-dev/apibrasil-py/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ivanildobarauna-dev%2Fapibrasil-py/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":268024276,"owners_count":24183134,"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","status":"online","status_checked_at":"2025-07-31T02:00:08.723Z","response_time":66,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"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":["apibrasil","apigratis","pip","portfolio-display","python3","sdk-python","whatsapp"],"created_at":"2025-04-11T22:52:54.645Z","updated_at":"2025-08-03T22:34:37.091Z","avatar_url":"https://github.com/ivanildobarauna-dev.png","language":"Python","funding_links":["https://github.com/sponsors/jhowbhz","https://github.com/sponsors/IvanildoBarauna","https://issuehunt.io/r/jhowbhz"],"categories":[],"sub_categories":[],"readme":"# SDK Python - APIBrasil: Feito por desenvolvedores, para desenvolvedores.\n\nDesbloqueie todo o potencial dos seus projetos com a APIBrasil! Integre funcionalidades como API do WhatsApp, geolocalização, rastreamento de encomendas, consulta de CPF/CNPJ e muito mais. Crie soluções inteligentes, eficientes e funcionais com rapidez e simplicidade.\n\n## Documentações das APIs\nhttps://apibrasil.com.br/documentacoes\n\n\n## Features Disponíveis\n\n| Up  | Services available            | Description       | Free    | Stable   |\n------|-------------------------------|-------------------|---------| -------------------------| \n| ✅ | WhatsAppApi                   | API do WhatsApp                         |   ✅                      | ✅                   \n| ✅ | SMSApi                        | API de SMS              .               |   ✅                      | ✅                   \n| ✅ | CNPJApi                       | API Dados CNPJ Receita.                 |   ✅                      | ✅                   \n| ✅ | CPFApi.                       | API Dados de CPF Serasa.                |   ✅                      | ✅                   \n| ✅ | CorreiosAPI.                  | API Busca encomendas Correios Brazil.   |   🚧                      | ✅                   \n| ✅ | CEPGeoLocationAPI             | API CEP Geolocation + IBGE Brazil.      |   ✅                      | ✅                   \n| ✅ | VehiclesApi                   | API Placa Dados.                        |   ✅                      | ✅                   \n| ✅ | VehiclesApi                   | API Placa FIPE.                         |   ✅                      | ✅                   \n\n\n## Como usar esta SDK? \n\n1. Faça seu cadastro na plataforma -\u003e https://apibrasil.com.br\n\n2. Obtenha suas credenciais -\u003e https://plataforma.apibrasil.com.br/myaccount/credentials\n    - Importante: Você pode colocar suas credenciais diretamente em código o que chamamos de hard-coded, porém nós recomendamos que você coloque suas credenciais em variáveis de ambiente ou serviços gerenciados específicos para secrets.\n\n2. Como Instalar\n\n    * Usando pip\n\n    ``` bash\n    pip install api-brasil \n    ```\n\n    * Usando poetry\n\n    ``` bash\n    poetry add api-brasil \n    ```\n\n\n## Usando as APIs na prática, lets do this!\n\n### _WhatsAppApi_\n```python\nfrom api_brasil import APIBrasilClient, WhatsAppApi\n\n# Instancie o client da APIBrasil\napi_brasil_client = APIBrasilClien(bearer_token=\"your_bearer_token_here\")\n# Você pode encontrar o seu bearer token em https://apibrasil.com.br na área de Credenciais\n\n\n## Usando a API de WhatsApp\nwhatsapp_api = WhatsAppApi(api_brasil_client=api_brasil_client device_token=\"your_device_token_here\") \n### Você pode encontrar o seu device token em https://apibrasil.com.br na área de Dispositivos\n\n\n# # Enviando uma mensagem\nwhatsapp_api.to_number(phone_number=\"5511999999999\")   # Número de telefone para enviar a mensagem\nresponse, status_code = whatsapp_api.send_message(message=\"Hello, estou integrado com sucesso com Api Brasil!\")\n\nprint(response, status_code)\n\n\n# # Enviando um arquivo para o número definido no método to_number\nresponse, status_code = whatsapp_api.send_file(file_path=\"https://apibrasil.io/img/capa.png\", file_description=\"Bem vindo a API Brasil\")\n\nprint(response, status_code)\n\n```\n### _VehiclesAPI_\n\n```python\n\nfrom api_brasil import APIBrasilClient, VehiclesAPI\nfrom api_brasil.features.vehicles import Endpoints\n\n# Instancie o client da APIBrasil\napi_brasil_client = APIBrasilClien(bearer_token=\"your_bearer_token_here\")\n# Você pode encontrar o seu bearer token em https://apibrasil.com.br na área de Credenciais\n\n\n# # Usando a API de Veículos\nvehicles_api = VehiclesApi(api_brasil_client=api_brasil_client, device_token=\"your_device_token_here\")\nvehicles_api.set_plate(plate=\"ABC-1234\")  # Placa do veículo\nresponse, status_code = vehicles_api.consulta(vechiles_api_endpoint=Endpoints.dados) # Consulta os dados do veículo\n\nprint(response, status_code)\n```\n\n### _CNPJApi_\n```python\nfrom api_brasil import APIBrasilClient, CNPJApi\n\n# Instancie o client da APIBrasil\napi_brasil_client = APIBrasilClien(bearer_token=\"your_bearer_token_here\")\n# Você pode encontrar o seu bearer token em https://apibrasil.com.br na área de Credenciais\n\n\n# # Usando a API de CNPJ\ncnpj_api = CNPJApi(api_brasil_client=api_brasil_client, device_token=\"your_device_token_here\")\ncnpj_api.set_cnpj(cnpj=\"44.959.669/0001-80\")  # CNPJ\nresponse, status_code = cnpj_api.consulta() # Consulta os dados do CNPJ\n\nprint(response, status_code)\n```\n\n### _CorreiosApi_\n```python\n# # Usando a API de Correios\nfrom api_brasil import APIBrasilClient, CorreiosAPI\n\n# Instancie o client da APIBrasil\napi_brasil_client = APIBrasilClien(bearer_token=\"your_bearer_token_here\")\n# Você pode encontrar o seu bearer token em https://apibrasil.com.br na área de Credenciais\n\n\ncorreios_api = CorreiosAPI(api_brasil_client=api_brasil_client,\n                           device_token=\"your_device_token\")\ncorreios_api.set_track_code(track_code=\"PN123456789BR\")  # Código de rastreamento\nresponse, status_code = correios_api.track() # Rastreia o objeto\n\nprint(response, status_code)\n\n```\n\n### _GeoLocalizationAPI_\n```python\n# # Usando a API de Geolocalização de CEP\nfrom api_brasil import APIBrasilClient, CEPGeoLocationAPI\n\n# Instancie o client da APIBrasil\napi_brasil_client = APIBrasilClien(bearer_token=\"your_bearer_token_here\")\n# Você pode encontrar o seu bearer token em https://apibrasil.com.br na área de Credenciais\n\n\ncep_geolocation_api = CEPGeoLocationAPI(api_brasil_client=api_brasil_client,\n                           device_token=\"your_device_token\")\n                           \n\ncep_geolocation_api.set_cep(cep=\"00000-000\")  # CEP\nresponse, status_code = cep_geolocation_api.consulta() # Consulta a geolocalização do CEP\n\nprint(response, status_code)\n```\n\n### CPFApi\n```python\n# Usando a API de CPF\nfrom api_brasil import APIBrasilClient, CPFApi\n\n# Instancie o client da APIBrasil\napi_brasil_client = APIBrasilClien(bearer_token=\"your_bearer_token_here\")\n# Você pode encontrar o seu bearer token em https://apibrasil.com.br na área de Credenciais\n\n\ncpf_api = CPFApi(api_brasil_client=api_brasil_client,\n                           device_token=\"your_device_token\")\ncpf_api.set_cpf(cpf=\"00000000000\")  # CPF\nresponse, status_code = cpf_api.consulta() # Consulta os dados do CPF\nprint(response, status_code)\n\n```\n\n### _SMSApi_\n```python\n# Usando a API de SMS\nfrom api_brasil import APIBrasilClient, SMSApi\n\n# Instancie o client da APIBrasil\napi_brasil_client = APIBrasilClien(bearer_token=\"your_bearer_token_here\")\n# Você pode encontrar o seu bearer token em https://apibrasil.com.br na área de Credenciais\n\nsms = SMSApi(api_brasil_client=api_brasil_client,\n             device_token=\"your_device_token\")\n\nsms.set_phone_number(number=\"5511900000000\")  # Número de telefone \nresponse, status_code = sms.send(message=\"Hello, estou integrado com sucesso com Api Brasil!\") # Envia a mensagem\nprint(response, status_code)\n```\n\n# Canais de suporte e comunidade\n[![WhatsApp Group](https://img.shields.io/badge/WhatsApp-Group-25D366?logo=whatsapp)](https://chat.whatsapp.com/EeAWALQb6Ga5oeTbG7DD2k)\n[![Telegram Group](https://img.shields.io/badge/Telegram-Group-32AFED?logo=telegram)](https://t.me/apigratisoficial)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fivanildobarauna-dev%2Fapibrasil-py","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fivanildobarauna-dev%2Fapibrasil-py","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fivanildobarauna-dev%2Fapibrasil-py/lists"}