{"id":1077,"date":"2017-11-03T02:19:42","date_gmt":"2017-11-03T05:19:42","guid":{"rendered":"https:\/\/www.erudio.com.br\/blog\/?p=1077"},"modified":"2022-12-21T14:42:32","modified_gmt":"2022-12-21T17:42:32","slug":"criando-uma-simples-web-api-restful-em-net-core-2-0","status":"publish","type":"post","link":"https:\/\/www.erudio.com.br\/blog\/criando-uma-simples-web-api-restful-em-net-core-2-0\/","title":{"rendered":"Criando uma simples Web API RESTful em .NET Core 2.0"},"content":{"rendered":"

Fala pessoal nesse post criaremos uma pequena API RESTful<\/strong> totalmente do zero. Para isso no Visual Studio<\/strong> clique em Arquivo ? Novo ? Projeto<\/strong> ou simplesmente digite CTRL+Shift+N<\/strong>.<\/p>\n

\"Downloading<\/p>\n

Na tela a seguir selecione Visual C# ? .NET Core ? Aplicativo Web ASP.NET Core<\/strong>, defina o nome da sua solu\u00e7\u00e3o no meu caso SimpleRestfulAPIWithAspNetCore <\/strong>e o local em que o nosso c\u00f3digo ser\u00e1 salvo e clique em OK.<\/p>\n

\"Downloading<\/p>\n

Em seguida selecione API Web<\/strong> e clique em OK. Nesse ponto certifique-se de que .NET Core<\/strong> e ASP.NET Core 2.0<\/strong> estejam selecionados.<\/p>\n

\"Downloading<\/p>\n

Pronto nossa API<\/strong> j\u00e1 foi criada, se voc\u00ea for at\u00e9 o Gerenciador de Solu\u00e7\u00f5es<\/strong> ver\u00e1 algo muito parecido com a imagem abaixo.<\/p>\n

\"Downloading<\/p>\n

Por padr\u00e3o o Visual Studio<\/strong> cria as classes Program.cs<\/strong> e Startup.cs<\/strong> sendo que a primeira \u00e9 a classe principal da aplica\u00e7\u00e3o e a segunda \u00e9 onde definimos as configura\u00e7\u00f5es de HTTP<\/strong> e dos servi\u00e7os a serem adicionados ao container. Na pasta Controllers<\/strong> temos a classe ValuesController.cs<\/strong> que \u00e9 um template inicial de um servi\u00e7o REST<\/strong> com as opera\u00e7\u00f5es GET<\/strong>, POST<\/strong>, PUT<\/strong> e DELETE<\/strong>.<\/p>\n

\nusing System.Collections.Generic;\nusing Microsoft.AspNetCore.Mvc;\nnamespace SimpleRestfulAPIWithAspNetCore.Controllers\n{\n    [Route("api\/[controller]")]\n    public class ValuesController : Controller\n    {\n        \/\/ GET api\/values\n        [HttpGet]\n        public IEnumerable<string> Get()\n        {\n            return new string[] { "value1", "value2" };\n        }\n\n        \/\/ GET api\/values\/5\n        [HttpGet("{id}")]\n        public string Get(int id)\n        {\n            return "value";\n        }\n\n        \/\/ POST api\/values\n        [HttpPost]\n        public void Post([FromBody]string value)\n        {\n        }\n\n        \/\/ PUT api\/values\/5\n        [HttpPut("{id}")]\n        public void Put(int id, [FromBody]string value)\n        {\n        }\n\n        \/\/ DELETE api\/values\/5\n        [HttpDelete("{id}")]\n        public void Delete(int id)\n        {\n        }\n    }\n}\n<\/pre>\n
Apenas isso \u00e9 o suficiente para criar um primeiro endpoint b\u00e1sico. Se executarmos nossa aplica\u00e7\u00e3o e abrirmos o browser na seguinte URL http:\/\/localhost:53032\/api\/values<\/strong> nossa aplica\u00e7\u00e3o retornar\u00e1 o valor [“value1″,”value2”]<\/strong> que \u00e9 o retorno do nosso endpoint GET<\/strong>. Entretanto o REST \u201ccan\u00f4nico\u201d<\/strong> determina que uma verdadeira aplica\u00e7\u00e3o RESTful <\/strong>deve retornar os status code corretos para cada opera\u00e7\u00e3o. Se quiser uma explica\u00e7\u00e3o mais detalhada sobre HTTP Status Codes em Servi\u00e7os REST<\/a> confira esta postagem<\/a> e para entender mais sobre RESTful Web Services<\/a> confira esta postagem aqui<\/a>. Os status code mais comumente usados s\u00e3o:<\/p>\n
 <\/p>\n