Criando uma API RESTful com o NancyFx e .NET Core \| TreinaWeb Promoção no ar Matricule-se agora e garanta **54% de desconto** Termina em Tempo restante da oferta: 12 Horas 52 Min 29 Seg Tempo restante da oferta: 12 52 29 [Assinar →](https://www.treinaweb.com.br/checkout/pagamento/plano/anual?cupom=TW-SCLIENTE26) [ ](https://www.treinaweb.com.br) Explorar [ Quanto custa? ](#assinatura) [ FAQ ](https://www.treinaweb.com.br#faq) [Matricule-se](#assinatura) [ Entrar ](https://www.treinaweb.com.br/login) [ Início ](https://www.treinaweb.com.br) [ Artigos ](https://www.treinaweb.com.br/blog) Criando uma API RESTful com o NancyFx e .NET Core [ C# ](https://www.treinaweb.com.br/blog/categoria/csharp) [ .NET Core ](https://www.treinaweb.com.br/blog/categoria/net-core) [ Web Services ](https://www.treinaweb.com.br/blog/categoria/web-services) # Criando uma API RESTful com o NancyFx e .NET Core O NancyFX é um leve framework para o C#. Veja como utilizá-lo para criar uma API RESTful. [ Wladimilson M. Nascimento ](https://www.treinaweb.com.br/blog/autor/wladimilson-m-nascimento) 8 anos atrás ![](https://dkrn4sk0rn31v.cloudfront.net/uploads/2018/11/03160827/NANCY.png) Quando pensamos em API RESTful no C#, a primeira opção que vem a mente é o ASP.NET Web API. Ele é um ótimo framework, utilizado em vários sistemas, com uma abundante documentação e material de apoio. Mas ele não é a nossa única opção para a criação de API Rest. Em artigos passados, conhecemos o [ServiceStack](https://www.treinaweb.com.br/blog/criando-um-web-service-com-o-servicestack-parte-1/), mas outra opção que está crescendo é o [NancyFX](http://nancyfx.org/). Inspirado no framework Sinatra do Ruby, o **Nancy** é um framework de criação de serviços HTTP, leve e direto ao ponto. Tem por objetivo não atrapalhar o desenvolvedor. Ele obtém isso através de uma série de configurações padrões e convenções. Assim, com o Nancy é possível criar um site em minutos. Claro que todas as suas convenções e configurações podem ser alteradas, caso este seja o desejo do desenvolvedor. Para este artigo, mostrarei como é possível criar uma API simples, rapidamente utilizando o Nancy. ## Criando a aplicação Neste artigo estou utilizando o .NET Core, desta forma, mostrarei como criar a aplicação através do terminal. Inicialmente é necessário criar uma aplicação web vazia: ``` dotnet new web -n NancyAPI ``` No projeto criado, adicione a referência do Nancy: ``` dotnet add package Nancy --version 2.0.0-clinteastwood ``` Agora é necessário dizer ao ASP.NET que iremos utilizar o Nancy, para isso, faremos uso do OWIN. O OWIN significa “*Open Web Interface for .Net*. Ele é um conjunto de padrões voltados para o .NET, que visa facilitar e encorajar a implementação de projetos que tentam desacoplar a aplicação do servidor. Na prática ele define um middleware ao pipeline de execução de uma aplicação ASP.NET. Por se tratar de um middleware, deve ser configurado no método `Configure` da classe `Startup`: ```csharp public void Configure(IApplicationBuilder app, IHostingEnvironment env) { app.UseOwin(o => o.UseNancy()); } ``` Com isso, o Nancy já está ativo na nossa aplicação. ## Módulos No Nancy os endpoints devem ser definidos em módulos. Um módulo nada mais é que uma classe que herde a classe `NancyModule`. Esta classe pode ser definida em qualquer ponto do projeto, pois o Nancy fará uma busca pelos módulos quando um endpoint for invocado. O único ponto importante é que esta classe seja definida como pública (`public`) para que possa ser localizada. Por exemplo: ```csharp using Nancy; namespace NancyAPI.Module { public class HomeModule : NancyModule { public HomeModule() { Get("/", _ => "Hello World from Nancy!"); } } } ``` Note que a rota está sendo definida como o primeiro parâmetro do método `Get`. Como é possível supor, esta rota será invocada quando for solicitada através de uma requisição `GET`. O Nancy define métodos para os principais verbos do HTTP: - `Delete` = `DELETE`; - `Get` = `GET`; - `Head` = `HEAD`; - `Options` = `OPTIONS`; - `Post` = `POST`; - `Put` = `PUT`; - `Patch` = `PATCH`. No segundo parâmetro do método deve ser passado a referência de uma função ( uma `Function`), que no exemplo acima, se utiliza lambda para definir a função. Este é o padrão recomendado pelo Nancy. Ao executar a aplicação e acessar o endpoint definido, teremos o resultado: ![](https://dkrn4sk0rn31v.cloudfront.net/2018/11/30160802/hello-world-nancy.png) Simples, não é? ## Definindo a API RESTful Para exemplificar uma API REST, vamos definir um modelo: ```csharp namespace NancyAPI.Models { public class Pessoa { public int Id { get; set; } public string Nome { get; set; } } } ``` E um repositório: ```csharp using System.Collections.Generic; using NancyAPI.Models; using System.Linq; namespace NancyAPI.Repositories { public class PessoaRepository { private static Dictionary pessoas = new Dictionary(); public List GetAll(){ return pessoas.Values.ToList(); } public Pessoa Get(int id){ return pessoas.GetValueOrDefault(id); } public void Add(Pessoa pessoa){ pessoas.Add(pessoa.Id, pessoa); } public void Edit(Pessoa pessoa){ pessoas.Remove(pessoa.Id); pessoas.Add(pessoa.Id, pessoa); } public void Delete(int id){ pessoas.Remove(id); } } } ``` Agora só falta o nosso endpoint: ```csharp using Nancy; using Nancy.ModelBinding; using NancyAPI.Models; using NancyAPI.Repositories; namespace NancyAPI.Module { public class PessoaModule: NancyModule { public readonly PessoaRepository repository; public PessoaModule() { repository = new PessoaRepository(); Get("/pessoa/", _ => repository.GetAll()); Get("/pessoa/{id}", args => repository.Get(args.id)); Post("/pessoa/", args => { var pessoa = this.Bind(); repository.Add(pessoa); return pessoa; }); Put("/pessoa/{id}", args => { var pessoa = this.Bind(); pessoa.Id = args.id; repository.Edit(pessoa); return pessoa; }); } } } ``` Neste endpoint é possível notar que os argumentos da URL são obtidos através do parâmetro do lambda: ```csharp Get("/pessoa/{id}", args => repository.Get(args.id)); ``` Este parâmetro é um objeto dinâmico. Assim, o Nancy tentará obter o valor do argumento com base na propriedade informada. Já os dados passados na solicitação, podem ser obtidos pelo `Bind`: ```csharp var pessoa = this.Bind(); ``` O Nancy irá converter automaticamente os dados obtidos para o tipo de objeto indicado. Para testar os endpoints, podemos utilizar o Postman: ### POST ![](https://dkrn4sk0rn31v.cloudfront.net/2018/11/30160802/nancy-post.png) ### GET ![](https://dkrn4sk0rn31v.cloudfront.net/2018/11/30160801/nancy-get.png) ### PUT ![](https://dkrn4sk0rn31v.cloudfront.net/2018/11/30160800/nancy-put.png) ### GET ID ![](https://dkrn4sk0rn31v.cloudfront.net/2018/11/30160800/nancy-get-id.png) ## Conclusão Graças a sua estrutura simples, porém sofisticada, o Nancy tem atraído cada vez mais a atenção dos desenvolvedores. Se tornando uma ótima alternativa ao ASP.NET Web API. Caso necessite criar uma API REST, não esqueça de dar uma boa olhada nele. [ ![C# (C Sharp) - APIs REST com ASP.NET Web API](https://d2knvm16wkt3ia.cloudfront.net/assets/svg-icon/csharp.svg) Curso C# (C Sharp) - APIs REST com ASP.NET Web API Conhecer o curso ](https://www.treinaweb.com.br/curso/c-sharp-apis-rest-com-asp-net-web-api) Você pode ver o projeto apresentado neste artigo no meu [GitHub](https://github.com/wladimilson/NancyAPI). - [ #C# ](https://www.treinaweb.com.br/blog/tag/csharp) - [ #API ](https://www.treinaweb.com.br/blog/tag/api) - [ #.NET Core ](https://www.treinaweb.com.br/blog/tag/net-core) - [ #API REST ](https://www.treinaweb.com.br/blog/tag/api-rest) - [ #NancyFx ](https://www.treinaweb.com.br/blog/tag/nancyfx) - [ #Nancy ](https://www.treinaweb.com.br/blog/tag/nancy) Autor ![Wladimilson M. Nascimento](//secure.gravatar.com/avatar/f0dd442f156a3eacd2880e9cd0eafbd1?d=mm) ## Wladimilson M. Nascimento Instrutor, nerd, cinéfilo e desenvolvedor nas horas vagas. Graduado em Ciências da Computação pela Universidade Metodista de São Paulo. [Todos os artigos](https://www.treinaweb.com.br/blog/autor/wladimilson-m-nascimento) ## Continue estudando Transforme leitura em prática com os cursos e formações da TreinaWeb. [Ver cursos](https://www.treinaweb.com.br/cursos) Continue lendo ## Artigos relacionados - ![](https://dkrn4sk0rn31v.cloudfront.net/uploads/2019/12/03143715/CARTER-400x280.png) [ Desenvolvimento Back-end ](https://www.treinaweb.com.br/blog/categoria/desenvolvimento-back-end) 7 anos atrás ## [ Criando uma API RESTful com o Carter e .NET Core ](https://www.treinaweb.com.br/blog/criando-uma-api-restful-com-o-carter-e-net-core) O Carter é um framework para .NET Core, que permite criar API RESTful de forma rápida, simples e elegante. O conheça neste artigo. Ler artigo - ![](https://dkrn4sk0rn31v.cloudfront.net/uploads/2020/05/criando-api-restful-jax-rs-api-400x280.png) [ Java ](https://www.treinaweb.com.br/blog/categoria/java) 7 anos atrás ## [ Criando uma API RESTful com a JAX-RS API ](https://www.treinaweb.com.br/blog/criando-uma-api-restful-com-a-jax-rs-api) O Java define a especificação JAX-RS API para a criação de aplicações API RESTful, que pode ser facilmente utilizada com a implementação do Jersey. Ler artigo - ![](https://dkrn4sk0rn31v.cloudfront.net/uploads/2022/08/asp-net-conhecendo-as-minimal-api-400x280.png) [ C# ](https://www.treinaweb.com.br/blog/categoria/csharp) 4 anos atrás ## [ ASP.NET - Conhecendo a Minimal API ](https://www.treinaweb.com.br/blog/asp-net-conhecendo-as-minimal-api) Neste artigo vamos conhecer um dos recursos que foram adicionados no .NET 6/ASP.NET 6, que é um novo template de aplicações Web, a Minimal API. Ler artigo - ![](https://dkrn4sk0rn31v.cloudfront.net/uploads/2019/12/16113045/GRPC-400x280.png) [ Desenvolvimento Back-end ](https://www.treinaweb.com.br/blog/categoria/desenvolvimento-back-end) 7 anos atrás ## [ Serviços gRPC no ASP.NET Core ](https://www.treinaweb.com.br/blog/servicos-grpc-no-asp-net-core) Aprenda o que é gRPC e como criar um serviço com esta tecnologia no ASP.NET Core. Ler artigo - ![](https://dkrn4sk0rn31v.cloudfront.net/uploads/2019/09/09160454/SGBDs-400x280.png) [ Bancos de Dados ](https://www.treinaweb.com.br/blog/categoria/bancos-de-dados) 5 anos atrás ## [ Tipos de banco de dados NoSQL ](https://www.treinaweb.com.br/blog/tipos-de-banco-de-dados-nosql) Veja neste artigo os principais tipos de banco de dados NoSQL. Ler artigo - ![](https://dkrn4sk0rn31v.cloudfront.net/uploads/2022/01/criando-uma-api-com-spring-data-jpa-e-spring-web-400x280.png) [ Desenvolvimento Back-end ](https://www.treinaweb.com.br/blog/categoria/desenvolvimento-back-end) 5 anos atrás ## [ Criando uma API com Spring Data JPA e Spring Web ](https://www.treinaweb.com.br/blog/criando-uma-api-com-spring-data-jpa-e-spring-web) Neste artigo vamos aprender como criar uma API com persistência de dados utilizando o Spring Web MVC e o Spring Data JPA. Ler artigo - ![](https://dkrn4sk0rn31v.cloudfront.net/uploads/2019/07/05112250/SPRING-BOOT-400x280.png) [ Desenvolvimento Back-end ](https://www.treinaweb.com.br/blog/categoria/desenvolvimento-back-end) 7 anos atrás ## [ Criando uma API REST com o Spring Boot ](https://www.treinaweb.com.br/blog/criando-uma-api-rest-com-o-spring-boot) Todos os passos da criação de uma API REST com o framework Spring Boot do Java, no Visual Studio Code. Ler artigo - ![](https://dkrn4sk0rn31v.cloudfront.net/uploads/2019/04/16095041/OCELOT-400x280.png) [ C# ](https://www.treinaweb.com.br/blog/categoria/csharp) 8 anos atrás ## [ Criando um API Gateway com ASP.NET Core e Ocelot ](https://www.treinaweb.com.br/blog/criando-um-api-gateway-com-asp-net-core-e-ocelot) Conheça o conceito de API Gateway e veja como criá-lo em uma aplicação ASP.NET utilizando a biblioteca Ocelot. Ler artigo - ![](https://dkrn4sk0rn31v.cloudfront.net/uploads/2020/01/06113752/streaming-api-400x280.png) [ C# ](https://www.treinaweb.com.br/blog/categoria/csharp) 7 anos atrás ## [ ASP.NET Core - Criando uma Streaming API ](https://www.treinaweb.com.br/blog/asp-net-core-criando-uma-streaming-api) Streaming não se resume apenas a conteúdo de media. Aprenda neste artigo como criar uma streaming API de dados no ASP.NET Core. Ler artigo - ![](https://dkrn4sk0rn31v.cloudfront.net/uploads/2022/03/o-que-e-fastapi-400x280.png) [ Desenvolvimento Back-end ](https://www.treinaweb.com.br/blog/categoria/desenvolvimento-back-end) 4 anos atrás ## [ Criando o primeiro CRUD com FastAPI ](https://www.treinaweb.com.br/blog/criando-o-primeiro-crud-com-fastapi) Neste artigo nós iremos aprender um pouco mais sobre o FastAPI durante o desenvolvimento de uma API com todas as operações de CRUD. Ler artigo - ![](https://dkrn4sk0rn31v.cloudfront.net/uploads/2020/01/05103838/SIGNALR-400x280.png) [ C# ](https://www.treinaweb.com.br/blog/categoria/csharp) 7 anos atrás ## [ Criando um Chat com ASP.NET Core SignalR ](https://www.treinaweb.com.br/blog/criando-um-chat-com-asp-net-core-signalr) Continuando o estudo do SignalR, aprenda como criar um chat utilizando esta biblioteca de aplicações em tempo real do ASP.NET Core. Ler artigo - ![](https://dkrn4sk0rn31v.cloudfront.net/uploads/2018/01/10094842/service-stack-1-400x280.png) [ C# ](https://www.treinaweb.com.br/blog/categoria/csharp) 9 anos atrás ## [ Criando um Web Service com o ServiceStack - Parte 1 ](https://www.treinaweb.com.br/blog/criando-um-web-service-com-o-servicestack-parte-1) Nesta primeira parte, veja como criar um web service simples no .NET Core utilizando a biblioteca ServiceStack. Ler artigo ## Um ano de acesso total para você viver de programação. Todos os cursos e formações da TreinaWeb numa única assinatura, com professores que atuam no mercado, suporte direto e certificados. Do primeiro `console.log` ao mercado de trabalho. - **1 ano** de acesso a **todos os cursos** - Cursos novos **toda semana** - Suporte **direto com professores** - Plano de carreira **personalizado** - **Certificados digitais** inclusos - **Aplicativos** para Android e iOS, com **acesso offline** **Garantia incondicional de satisfação** Teste por 7 dias e, se não fizer sentido para você, devolvemos seu dinheiro. ### Acesso completo a todos os cursos e dezenas de Formações. 12 meses Economize R$ 840,00 54% OFF de 12x R$ 129,00 por apenas 12x R$ 59,00 sem juros no cartão de crédito ou R$ 599,00 à vista Oferta termina em **12h 52min 29s** - Acesso imediato e ilimitado durante 1 ano. - Plano de carreira personalizado. - Suporte direto com professores. - E muito mais! [Matricule-se agora](https://www.treinaweb.com.br/checkout/pagamento/plano/anual?cupom=TW-SCLIENTE26) [ ](https://www.treinaweb.com.br) Escola online de programação, tecnologia e IA. - [ ](https://www.facebook.com/TreinaWeb/) - [ ](https://www.instagram.com/treinaweb/) - [ ](https://www.youtube.com/user/TreinaWeb) - [ ](https://twitter.com/treinaweb) - [ ](https://www.linkedin.com/company/treinaweb) - [ ](https://github.com/treinaweb) ## Inscreva-se em nossa newsletter Receba lançamentos, promoções e novidades. Seu nome Seu WhatsApp Seu melhor e-mail Inscrever-se ## Cursos - [ Base para Devs ](https://www.treinaweb.com.br/categoria/base-para-devs) - [ Front-end ](https://www.treinaweb.com.br/categoria/desenvolvimento-front-end) - [ Back-end ](https://www.treinaweb.com.br/categoria/desenvolvimento-back-end) - [ Mobile ](https://www.treinaweb.com.br/categoria/desenvolvimento-mobile) - [ Bancos de Dados ](https://www.treinaweb.com.br/categoria/bancos-de-dados) - [ Cloud ](https://www.treinaweb.com.br/categoria/cloud-computing) - [ IA ](https://www.treinaweb.com.br/categoria/ia) - [ E mais ](https://www.treinaweb.com.br/categoria/e-mais) - [ Ver todos os cursos ](https://www.treinaweb.com.br/cursos) ## Conteúdo - [ Formações ](https://www.treinaweb.com.br/formacoes) - [ Projetos práticos ](https://www.treinaweb.com.br/projetos-praticos) - [ Direto ao ponto ](https://www.treinaweb.com.br/direto-ao-ponto) - [ Planos ](https://www.treinaweb.com.br#assinatura) - [ Depoimentos ](https://www.treinaweb.com.br#depoimentos) - [ Comunidade ](https://www.treinaweb.com.br#comunidade) - [ Corpo docente ](https://www.treinaweb.com.br#docente) ## A empresa - [ Sobre a TreinaWeb ](https://www.treinaweb.com.br#sobre) - [ Perguntas frequentes ](https://www.treinaweb.com.br#faq) - [ Vantagens de estudar na TreinaWeb ](https://www.treinaweb.com.br/vantagens-de-estudar-na-treinaweb) - [ Cursos para empresas ](https://www.treinaweb.com.br/empresas) - [ Sugira um novo curso ](https://www.treinaweb.com.br/sugerir-curso) - [ Trabalhe conosco ](https://www.treinaweb.com.br/trabalhe-conosco) - [ Artigos ](https://www.treinaweb.com.br/blog) - [ Desenvolvedores e agentes ](https://www.treinaweb.com.br/developers) - [ Contato ](https://www.treinaweb.com.br/contato) - [ Política de privacidade ](https://www.treinaweb.com.br/politica-de-privacidade) - [ Termos de uso ](https://www.treinaweb.com.br/termos-de-uso) ## Baixe nosso aplicativo [ Disponível na **App Store** ](https://apps.apple.com/us/app/treinaweb/id1322729447) [ Disponível no **Google Play** ](https://play.google.com/store/apps/details?id=br.com.treinaweb.mobile) Av. Paulista, 1765, Conj 71 e 72 · Bela Vista · São Paulo · SP · 01311-200 © 2004 – 2026 TreinaWeb Tecnologia LTDA · CNPJ 06.156.637/0001-58