Simples endpoints para recurso "Pessoa"

Endpoints para "Pessoa" utilizando segregação de interfaces e desacoplamento com o framwork Laravel v8.75.

• POST: Recebe a informação de uma pessoa física (nome, cpf, endereço e whatsapp) e salva em um banco de dados (aqui utilizado o SQLite, por simplificação).
• GET: Buscar os dados de uma pessoa no banco a partir do seu CPF.

Instalação

OBTENÇÃO DO CÓDIGO FONTE

Condiderando que o git já está instalado na sua máquina e utilizando o terminal execute os comandos abaixo:

$ git clone https://github.com/aroldosantos/pessoa-endpoints-app.git

$ cd pessoa-endpoints-app

Pode-se também apenas realizar o download do zip e decompactar onde desejar.

Na pasta pessoa-endpoints-app execute os comandos abaixo:

$ composer install

Faça uma cópia do aquivo .env.example e renomei-o para apenas .env

Execute o comando:

$ php artisan key:generate

Navegue para a pasta database e nela, crie um arquivo SqLite para a base de dados, com o nome: pessoa-endpoints-app.sqlite.

$ cd database

$ touch pessoa-endpoints-app.sqlite

Abra o .env e procure pelas entradas:

DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=laravel
DB_USERNAME=root
DB_PASSWORD=

e substitua por:

DB_CONNECTION=sqlite
DB_DATABASE=path-absoluto-para-o-arquivo-pessoa-endpoints-app.sqlite

no meu ficou assim:

DB_CONNECTION=sqlite
DB_DATABASE=/Users/meu-usuario/Sites/pessoa-endpoints-app/database/pessoa-endpoints-app.sqlite

Na pasta raiz do projeto - pessoa-endpoints-app - digite o comando:

$ php artisan migrate

Depois inicie o servidor com o comando:

$ php artisan serve

Aparecerá um aviso de inicialização do servidor php com algo como:

Starting Laravel development server: http://127.0.0.1:8000

[Thu Jan 20 10:06:50 2022] PHP 7.4.21 Development Server (http://127.0.0.1:8000) started

Usando o recurso "Pessoa"

Utilizando um cliente de API como o Postman acesse os recursos e teste os endpoints:

• POST: Recebe a informação de uma pessoa física (nome, cpf, endereço e whatsapp) e salva em um banco de dados (aqui utilizado o SQLite, por simplificação).
• URL: http://127.0.0.1:8000/api/pessoas

• GET: Buscar os dados de uma pessoa no banco a partir do seu CPF.
• URL: http://127.0.0.1:8000/api/pessoas/99999999999