Hola en este tutorial dividido en diferentes partes aprenderás como implementar una aplicación de web api con C# de manera sencilla y rápida.
La web API consiste en crear un servicio de consulta por código postal de la república mexicana para obtener información de colonias, municipios, estado, ciudad etcétera.
Algunos de los temas que veremos.
- Web API
- SQL Managmente Studio
- Importación masiva de datos con SQL MS
- PostMan
- Data Annotations
- Seguridad con Json Web Tokens (JWT).
Importando información de un XLS a la base de datos
Hay muchas maneras de importar data, en este caso usaremos la herramienta nativa de SQL Managment.
Nos dirigimos a nuestro SQL Management Studio y seleccionamos nuestra base de datos y damos clic derecho y nos luego a Task/Tareas, finalmente damos click en Import data, se nos abrirá la siguiente ventana con una serie de pasos.
En la primer ventana donde seleccionamos el origen de datos buscamos Microsoft Excel y seleccionamos nuestro archivo, la versión la dejamos en 2003.
En la siguiente ventana seleccionaremos el destino el cual será SQL Server Native Client.
El siguiente venta a configurar tendremos que mapear la hoja de excel de nuestra tabla ya creada, tengan cuidado por que en la columna destino les tratará de crear una nueva tabla como se llama la hoja de excel, le daremos en editar asignaciones para mapear los campos.
Le damos siguiente y dejamos todo por default hasta llegar el final y si todo sale bien no generará ningún error.
La inserción es demasiada rápida, no debería tardar más de 5 segundos
Creando nuestro controlador
Vamos a dirigirnos a la carpeta Controllers y daremos click derecho -> Agregar controlador
Nos vamos a Común -> API y seleccionamos: Controlador de API con acciones que usan Entity Framework
Seleccionamos los siguientes parámetros y renombramos el controlador a CodigosPostalesController
y le damos en agregar y nos creara un archivo con todos los verbos/métodos.
Probando el controlador
Agregamos un registro de prueba en nuestra tabla, luego volvemos a nuestro visual studio e iniciamos la depuración, probamos la url de nuestro api
/api/CodigosPostales
Como podemos ver ya nos esta regresando nuestra información.
Probando en Postman
Abrimos nuestra aplicación y agregamos una nueva colección para las futuras pruebas que estaremos realizando.
Agregamos una nueva solicitud, Add Request, basta poner el método GET y la url.
Seguridad
El paso siguiente será añadir seguridad a nuestra web api con JWT Tokens