gpereira62 / ControleCliente.API

Controle de Clientes

🚀 Web Api ASP .NET 5 Consumindo API - Ploomes Contacts

Requisitos • Tecnologias • Json API • Testando a API • Autor • License

🚧 Concluído 🚀 🚧

Requisitos

• Cadastro de cliente
• Atualizar um cliente existente pelo ID
• Consultar todos os clientes
• Consultar um cliente pelo ID
• Delete um cliente pelo ID
• Utilizar Entity Framework
• Utilizar JWT - Token Bearer
• Criar/Consultar/Alterar Usuário para JWT(JSON Web Token)
• Utilizar o SQL Server como banco de dados para o Usuário
• Utilizar o Design Pattern Repository para acessar o banco
• Utilizar o Swagger para Testar a API e Documenta-lá
• Realizar Testes Unitários nas requisições basicas

Tecnologias

As seguintes ferramentas foram usadas na construção do projeto:

• C#
• ASP .NET 5
• SQL Server
• Entity Framework
• Swagger
• XUnit
• NSubstitute
• HtppClient
• JWT

Json API

{ // Cliente
  "id": 1,                        // Id do Cliente
  "name": "gustavo",              // Nome do Cliente
  "email": "[e-mail]", // Email do Cliente
}
{ // Usuario
  "usuarioid": 1,                 // Id do Usuario
  "login": "gustavo",             // Login do Usuario
  "senha": "1234",                // Senha do Usuario
}

Testando a API

Antes de começar, você vai precisar ter instalado em sua máquina as seguintes ferramentas:

• Git
• Visual Studio 2019

Caso você já tenha instalado no seu computador, segue as versões que foram utilizadas:

• Git: git version 2.32.0.windows.2
• Visual Studio 2019: 16.10.3

Passo a Passo:

• Clone o repositório no seu computador;
  • Comando: git clone https://github.com/gpereira62/ControleCliente.API.git
• Entre na pasta e execute o arquivo "ControleCliente.API", abra ele pelo Visual Studio 2019;
• Com o Visual Studio 2019 aberto, na barra de pesquisa, pesquise por "Package Manager Console" e abra essa janela;
• Ao abrir, execute o comando "Update-database";
• Agora execute o projeto;
  • Url: https://localhost:44382/swagger/index.html

Como o projeto está utilizando JWT(JSON Web Token), será necessário seguir o passo a passo para realizar as requisições:

• Crie um usuário primeiro
  • POST - https://localhost:44382/api/v1/usuarios
• E então pegue o Token utilizando o usuário cadastrado, Login e Senha
  • POST - https://localhost:44382/api/v1/conta/login
• Com o Token, adicione no Authorize do Swagger

Autor

_{Gustavo Pereira} 🚀

Feito com ❤️ por Gustavo Pereira 👋🏽 Entre em contato!

        

License

This project is under the MIT license. See the LICENSE for more information.