Creando el primer proyecto ASP.NET Web Api

Después de entender un poco en mi post anterior qué es ASP.NET Web Api, vamos a empezar con una serie de artículos para ir entrando en materia y conocer cómo trabajar con este tipo de aplicaciones. En este artículo vamos a ver cómo se crea un proyecto ASP.NET Web Api en Visual Studio. Les voy a mostrar cómo hacerlo desde Visual Studio 2012 y Visual Studio 2013 debido a una diferencia incorporada en esta última versión para crear los proyectos, pero al final la solución creada será igual.

Para iniciar, seleccionamos la opción de crear un nuevo proyecto.

primerproyecto_webapi_01

Si estamos en Visual Studio 2012, seleccionamos tipo de proyecto “ASP.NET MVC 4 Web Application” dentro de los templates web, y en el próximo cuadro de diálogo seleccionamos un proyecto tipo Web Api.

primerproyecto_webapi_02

primerproyecto_webapi_03

Si estamos en Visual Studio 2013, seleccionamos tipo de proyecto “ASP.NET Web Application” dentro de los templates web, y en el próximo cuadro de diálogo seleccionamos un proyecto tipo Web Api.

primerproyecto_webapi_04

primerproyecto_webapi_05

Esta era la diferencia que les mencionaba al principio del post. En Visual Studio 2013 ahora solo existe un tipo de template para los proyectos web. Para entender más sobre esto te invito a leer sobre el tema One ASP.NET

Entendido lo anterior y hechos los pasos anteriores según la versión de Visual Studio en la que estemos, se generará una solución base de ASP.NET Web Api.

primerproyecto_webapi_06

Al buscar en la carpeta Controllers, encontraremos un archivo llamado “ValuesController” en el que nos encontraremos el siguiente código fuente:

    public class ValuesController : ApiController
    {
        // GET api/values
        public IEnumerable<string> Get()
        {
            return new string[] { "value1""value2" };
        }
 
        // GET api/values/5
        public string Get(int id)
        {
            return "value";
        }
 
        // POST api/values
        public void Post([FromBody]string value)
        {
        }
 
        // PUT api/values/5
        public void Put(int id, [FromBody]string value)
        {
        }
 
        // DELETE api/values/5
        public void Delete(int id)
        {
        }
    }

Este archivo se genera con una estructura básica de ejemplo de como es un controlador en Web Api, entre lo cual podemos destacar dos cosas:

  • Los controladores de Web Api heredan de la clase ApiController
  • Los métodos generados corresponden a diferentes acciones con verbos HTTP (Get, Post, Put, Delete).
  • Cada método tiene un comentario que indica la ruta del método.

Al compilar y abrir el sitio web del proyecto que hemos creado, podremos ver cómo se ejecuta el método GET si accedemos a la URL api/values. El tipo de contenido por defecto es XML.

primerproyecto_webapi_07

Bueno, es todo por el momento, creamos un primer proyecto y vimos algunos aspectos básicos. En próximos artículos comenzaremos a transformar este código en una API con más elementos 😀

Saludos.

Anuncios

4 Responses to Creando el primer proyecto ASP.NET Web Api

  1. Pingback: Creando una API con operaciones CRUD | hgr.net

  2. Pingback: Avanet – Creando una API con operaciones CRUD – Parte 1

  3. luisfqba says:

    Como siempre un muy buen post. Solo tengo una duda cómo es en el nuevo Visual Studio o nueva versión de Asp .Net? Es que he visto en algunos post que ya no se tiene una plantilla para Web Api. Estoy algo confundido. Podrías ayudarme con un comentario respecto a este tema? Saludos.

    • hgr says:

      Efectivamente Luis. En el nuevo ASP.NET Core ahora se cuenta con una sola plantilla para ASP.NET MVC Core. Dentro de esa solución podrás tener tus controladores Web API. Para más información puedes visitar este link de la documentación oficial de ASP.NET. Igualmente, en un futuro vas a encontrar más información sobre ASP.NET Core en este blog, sigue atento. Saludos.

Responder

Introduce tus datos o haz clic en un icono para iniciar sesión:

Logo de WordPress.com

Estás comentando usando tu cuenta de WordPress.com. Cerrar sesión / Cambiar )

Imagen de Twitter

Estás comentando usando tu cuenta de Twitter. Cerrar sesión / Cambiar )

Foto de Facebook

Estás comentando usando tu cuenta de Facebook. Cerrar sesión / Cambiar )

Google+ photo

Estás comentando usando tu cuenta de Google+. Cerrar sesión / Cambiar )

Conectando a %s

A %d blogueros les gusta esto: