Servicios Web Rest ASP.

NET MVC
La intención de este tutorial es mostrar cómo implementar una API básica REST con ASP.NET
Web Api, la cual haga uso de los métodos CRUD del protocolo HTTP.
1. Abrir el Managment Studio de MS SQL Server y crear una BD llamada RegMat
2. Crear una tabla llamada asignaturas con la siguiente estructura.
3. Abrir el MS Visual Studio y crear un nuevo proyecto:

4. Indicamos que es un proceso MVC, WebApi y sin autenticación.

5. Haciendo uso del ORM por defecto de .NET (Entity Framework) haré uso de mi repositorio
de datos (tabla en MS SQL Server). Encima del nombre de proyecto
(WebApiAsignaturas), presiono el botón derecho y selecciono “New Item…” del menú
contextual.
6. Seleccionamos la pestaña “Data”y de ella el tipo de acceso a datos que utilizaremos:
7. Esto da inicio al asistente de creación del modelo y su contexto, en el cual se solicita
inicialmente la forma en que abordaremos el acceso a datos. Seleccionamos “From
DataBase”.
8. Procedemos a crear una nueva conexión hacia la BD que habíamos creado.

9. Presionamos “OK” y luego “Next”. En el siguiente cuadro de dialogo seleccionamos la

versión de Entity Framework que tengamos instalada:
10. Presionamos siguiente. Aquí seleccionamos las fuentes de datos, Singularizar los objetos, y
agregar FK:
11. Presionamos “Finish”, con lo cual el asistente construye los objetos necesarios en base a
nuestra selección.
12. Por último, es probable que se nos muestren dos cuadros de dialogo solicitando
autorización para que el asistente descargue ciertas dependencias usando “Nugets”,
presionamos OK en ambos casos. Es prudente que compilemos el proyecto para asegurar
que las clases del modelo sean accesibles por el asistente “scaffold”.

13. Ahora procederemos a agregar el controlador que nos permitirá realizar las operaciones
CRUD, para esto hacemos clic derecho sobre la carpeta de “Controllers” y seleccionamos
“Add” y luego “New Scaffolded Item”.
14. En cuadro de dialogo mostrado, seleccionamos la plantilla “Web API 2 Controller con
acciones, utilizando Entity Framework”.

15. Especificamos el nombre del controlador, la clase del modelo, el contexto de la BD y

presionamos “Add”.
16. Ahora contamos con 5 acciones accesibles por medio de una API REST, las cuales permiten
las operaciones CRUD sobre el objeto Asignatura.
 GetAsignaturas. Devuelve una lista de las Asignaturas almacenadas en la base de
datos.
 GetAsignatura(int id). Devuelve una Asignatura identificada por su Id.
 PutAsignatura(int id, Asignatura asignatura) Modifica una Asignatura identificada
por su Id.
 PostAsignatura(Asignatura asignatura) Inserta una nueva Asignatura.
 DeleteAsignatura(int id) Borra una Asignatura identificada por su Id.

17. Para probar su funcionalidad, navegamos a la siguiente URL:

http://localhost:51528/api/Asignaturas/
Recuerde que el puerto será distinto en su caso
Algunos enlaces que pudieran ser de interés:

http://forums.asp.net/t/2019962.aspx?call+web+api+methods+to+test+in+browser
http://stackoverflow.com/questions/12629144/how-to-force-asp-net-web-api-to-always-
return-json