Uma API para gerenciamento de pessoas.
Esta API que tem como objetivo cadastrar criar uma pessoa e adicionar seu endereço /person
.
Esta API fornece endpoints e ferramentas HTTP para:
- Criar uma pessoa
POST//person
. - Editar uma pessoa
UPDATE//person/:id
- Consultar uma pessoa
GET//person/:id
- Listar pessoas
GET//person/
Body:
{
"name": "Gabriel",
"birthDate": "1995-03-18"
}
Onde:
name
- É o nome da pessoa.
birthDate
- A data de nascimento.
- Criar endereço para pessoa
POST//person/:personId/adress
- Listar endereços da pessoa
GET//person/:personId/adress
Body:
{
"street": "Rua",
"cep": "00000",
"number" : "1",
"city" : "Cidade"
}
- Poder informar qual endereço é o principal da pessoa
PUT//person/:personId/
Body:
{
"name": "Gabriel",
"birthDate": "1995-03-15",
"principalAdress":{
"id":"1"
}
}
Retornos possíveis:
- 201 - Created: Tudo ocorreu como esperado.
- 400 - Bad Request: A requisição não foi aceita, geralmente devido à falta de um parâmetro obrigatório ou JSON inválido.
- 404 - Not Found: Id informado não foi encontrado.
- 500 - Server Errors: Erro interno.
Este projeto foi desenvolvido utilizando:
- Java 1.8 (Java Development Kit - JDK: 1.8 )
- Spring Boot 2.7.7
- Maven
- JUnit 5
- H2Dialect
- Postman
- Heroku
- Para a fase de teste unitários, você pode executar:
mvn clean test
- Postman (development environment): https://documenter.getpostman.com/view/21229006/2s8ZDVZiHN