Esta aplicação gerencia dados de Fornecedor e Produto para sistemas de controle de logística.
O projeto pode ser usado como modelo para construção de WebAPI REST com ASP.NET Core de forma prática. Atualmente as funciolidades envolvem operações de:
- Autenticação e permissão de acesso de usuário via JWT (JSON Web Token);
- CRUD de Fornecedor e Produtos;
- Upload de Imagem (com a opção de utilizar imagens relativamente grandes).
Na versão atual suprimi o bloqueio à aplicação, deixando o acesso ao Swagger público via Cloud. Você pode acessar a versão atual e as anteriores aqui.
Para executar a aplicação, será necessário instalar:
Para iniciar o desenvolvimento, é necessário clonar o projeto do GitHub num diretório de sua preferência:
cd "diretorio de sua preferencia"
git clone https://github.com/AlessandraLino/FornecedorAPI.gitPara construir o projeto utilize o comando abaixo:
dotnet build [<PROJECT>|<SOLUTION>] [-c|--configuration <CONFIGURATION>]
[-f|--framework <FRAMEWORK>] [--force] [--interactive] [--no-dependencies]
[--no-incremental] [--no-restore] [--nologo] [-o|--output <OUTPUT_DIRECTORY>]
[-r|--runtime <RUNTIME_IDENTIFIER>] [--source <SOURCE>]
[-v|--verbosity <LEVEL>] [--version-suffix <VERSION_SUFFIX>]
dotnet build -h|--help
O comando dotnet build compila o projeto e suas dependências em um conjunto de binários. Os binários incluem o código do projeto em arquivos de IL (linguagem intermediária) com uma extensão . dll . Dependendo do tipo de projeto e das configurações, outros arquivos podem ser incluídos. (Veja mais em Comandos de CLI)
O arquivo appsettings.Development e Staging configuram publicação nesses respectivos ambientes. Já em Produção os dados foram configurados na plataforma Azure. Para não expor dados desse ambiente neste repositório foi utilizado o Management User Secrets.
- Utilize o endpoint "/api/v1/nova-conta" para registrar um usuário;
- Insira o usuário e senha no body do endpoint "/api/v1/entrar";
- Obtenha o conteúdo de "accessToken" da resposta;
- Insira-o em Autorize (canto superior direito).
Verifique também o token obtido em jwt.io
Métodos que não requerem permissão via Claims na versão 1.0: