"Pedro Fernandes";

Olá pessoal.

Hoje vou falar de um novo recurso presente no ASP.NET MVC 4 e que é bem interessante, se trata do ASP.NET Web API, um framework desenvolvido para criarmos uma Web API para nossa aplicação.

Web API são um conjunto de serviços expostos através da internet que possibilita a integração entre a aplicação e diversos clientes que vão desde uma página acessando a aplicação via Ajax até um aplicativo nativo em um dispositivo móvel acessando diretamente a aplicação. Exemplos comuns de Web API são as APIs do Facebook, do Twitter e do LinkedIn.

O que é possível com o ASP.NET Web API?

Para começar, criar uma Web API é como criar um controller comum do ASP.NET MVC, exceto que ele herda da classe ApiController e não retornará uma View, mas sim dados serializados em XML, JSON ou dados de formulários criptografados. O tipo de dado retornado pode ser definido no lado servidor ou negociado com o cliente de forma dinâmica. Veja dois exemplos abaixo:

    public class ProdutoController : ApiController
    {
            public HttpResponseMessage GetProduto()
            {
                Produto produto = new Produto();
                produto.Codigo = 1;
                produto.Valor = 100.00M;
                produto.Nome = "TESTE";

                HttpResponseMessage<Produto> response = new HttpResponseMessage<Produto>(produto,
                            new MediaTypeHeaderValue("application/json"));

                return response;
            }
    }

Ao chamar o endereço http://localhost:{PORTA}/api/produto/getproduto, irá aparecer o objeto Produto serializado em XML.

<Produto xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">
<Nome>TESTE</Nome>
<Valor>100.00</Valor>
<Codigo>1</Codigo>
</Produto>

Mudando a linha onde tem:
MediaTypeHeaderValue(“application/xml”)
por
MediaTypeHeaderValue(“application/json”)
o mesmo Produto é retornado em JSON:

{“Codigo”:1,”Nome”:”TESTE”,”Valor”:100.00}

Outro recurso bem interessante é que podemos retornar um objeto IQueryable e realizar consultas nele diretamente pela chamada da URL!
Usando as convenções de URL do protocolo OData. Por exemplo, imagine o seguinte método em nosso ProdutoController:

public IQueryable<Produto> GetListaProdutos()
{
    return repository.GetProdutos().AsQueryable();
}

Usando as convenções do OData, podemos por exemplo, determinar o filtro da lista pela URL:

http://localhost:{PORTA}/api/produto/getlistaprodutos?$orderby=Nome

Estes recursos são muito úteis quando queremos disponibilizar algum tipo de integração com nossa aplicação, seja apenas para consultar os dados quanto para executar algum tipo de função como postar uma mensagem no mural do Facebook por exemplo.

Isso é apenas uma parte do que podemos fazer com o ASP.NET Web API.