Download the PHP package andreoneres/brasilapi-php without Composer
On this page you can find all versions of the php package andreoneres/brasilapi-php. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download andreoneres/brasilapi-php
More information about andreoneres/brasilapi-php
Files in andreoneres/brasilapi-php
Package brasilapi-php
Short Description BrasilAPI PHP Library
License MIT
Homepage https://brasilapi.com.br
Informations about the package brasilapi-php
Vamos transformar o Brasil em uma API?
Introdução
Vamos transformar o Brasil em uma API?
Esse SDK foi construído com o intuito de ser flexível, de forma que todos possam utilizar todas as features e versões da BrasilAPI.
Você pode acessar a documentação oficial da BrasilAPI acessando esse link.
Índice
- Introdução
- Índice
- Requisitos
- Instalação
- Utilização
- Endpoints
- Bancos
- CEP
- CEP V2
- CNPJ
- Corretoras
- CPTEC
- DDD
- Feriados
- FIPE
- IBGE
- ISBN
- NCM
- Pix
- Registro BR
- Taxas
- Criando endpoints
- Tratando exceções
- Testes
- Contribuindo
- Licença
Requisitos
- PHP versão 8.1 ou maior;
- Guzzle Http versão 7.4 ou maior.
Instalação
Para instalar o SDK, você deve utilizar o Composer com o seguinte comando:
Utilização
O uso mais simples da biblioteca seria o seguinte:
Endpoints
Abaixo você pode ver todos os endpoints disponíveis, por padrão, na biblioteca:
Bancos
Buscando todos os bancos disponíveis na API.
Buscando um banco específico pelo seu código.
CEP
Buscando um CEP específico.
CEP V2
Buscando um CEP específico.
CNPJ
Buscando um CNPJ específico.
Corretoras
Buscando uma corretora específica pelo CNPJ.
Buscando todas as corretoras listadas pela CVM.
CPTEC
Buscando uma cidade pelo nome.
Buscando todas as cidades disponíveis.
Buscando as informações meteorológicas em todas as capitais dos estados brasileiros.
Buscando as informações meteorológicas em um aeroporto específico através do seu código ICAO.
Buscando as informações meteorológicas de uma cidade específica pelo seu código.
Buscando as informações meteorológicas de uma cidade específica no período de X dias.
Obs.: O primeiro parâmetro se refere ao código da cidade e o segundo parâmetro refere-se a quantidade de dias. Lembrando que só é possível buscar informações entre 1 a 6 dias.
Buscando a previsão oceânica em uma cidade específica.
Buscando a previsão oceânica em uma cidade específica no período de X dias.
Obs.: O primeiro parâmetro se refere ao código da cidade e o segundo parâmetro refere-se a quantidade de dias. Lembrando que só é possível buscar informações entre 1 a 6 dias.
DDD
Buscando o estado e cidades que possuem determinado DDD.
Feriados
Buscando todos os feriados nacionais em determinado ano.
FIPE
Buscando todas as marcas de veículos referente a um tipo de veículo.
Buscando o preço de um veículo específico pelo seu código FIPE.
Buscando as tabelas de referência existentes.
IBGE
Buscando todos os municípios de um estado específico pela sua sigla.
Buscando informações de todos os estados brasileiros.
Buscando informações de um estado específico pela sua sigla.
ISBN
Buscando informações sobre um livro específico pelo seu código ISBN.
NCM
Buscando informações sobre todos os NCMs.
Buscando informações sobre um NCM específico.
Buscando informações de um NCM a partir de um código ou descrição.
Pix
Buscando informações de todos os participantes do PIX no dia atual ou anterior.
Registro BR
Buscando informações de um domínio específico.
Taxas
Buscando as taxas de juros e alguns índices oficiais do Brasil.
Buscando informações de uma taxa a partir do seu nome/sigla.
Criando endpoints
Para adicionar novos ou sobreescrever os já existentes endpoints, você deve seguir os seguintes passos:
-
Crie uma classe que extenda a classe
BrasilApi\Endpoints\Abstracts\Endpoint
; - Nesta classe, você pode implementar todos os métodos que desejar e utilizar o método
$this->client->request()
para enviar as requisições para a API. Lembre-se que a base URL da API já está embutido no 'Client', portanto na uri do método você precisa adicionar apenas o complemento da rota.
Exemplo:
URL: https://brasilapi.com.br/api/cep/v2/01001000
BASE_URI: https://brasilapi.com.br/api
URI: /cep/v2/01001000
- Para incorporá-lo ao SDK, você deve possuir uma instância de
BrasilApi\Client
e utilizar o métodoaddEndpoint
, passando como parâmetro o nome do endpoint e a classe criada no passo 1.
Exemplo:
- Para utilizar este novo endpoint, você deve chamá-lo da seguinte forma:
Obs.: A chamada do método do endpoint deve ser feito com o mesmo nome que foi definido no método addEndpoint
, pois
ele será utilizado na busca dinâmica do endpoint através do método mágico __call
.
Obs.2: Além de criar, você pode sobrescrever endpoints existentes e atualizar os seus métodos. Isso pode ser útil caso seja lançada uma nova versão de algum endpoint e você queira utilizá-lo imediatamente. Dessa forma, você pode sobrescrever o endpoint existente e alterar a sua URI.
Tratando exceções
Caso a API retorne um erro, a biblioteca irá lançar uma exceção do tipo BrasilApi\Exceptions\BrasilApiException
.
Para capturar esta exceção, você deve utilizar o bloco try/catch
e tratar o erro da forma que desejar.
Exemplo:
Testes
Neste projeto é utilizado o Pest para a implementação de testes automatizados. Para executá-los, instale as dependências de desenvolvimento, caso não tenha instalado, e execute o seguinte comando:
Contribuindo
Para contribuir com o projeto, você deve seguir os seguintes passos:
- Faça um fork do projeto;
- Crie uma branch para sua alteração:
git checkout -b feat-fix-refactor/my-changes
; - Faça commit das suas alterações:
git commit -m 'feat-fix-refactor: My changes'
; - Faça push para a sua branch:
git push origin feat-fix-refactor/my-changes
; - Abra um pull request.
- Aguarde a análise do seu pull request.
- Se seu pull request for aceito, ele será mesclado com a branch
main
.
Obs.: Não se esqueça de criar testes para o seu código.
Licença
Veja em LICENSE.md.