Servicios REST con .NET Core
  • Servicios REST con ASP.NET Core y Entity Framework Core
  • 1. Introducción
    • 1.1 Instalación Visual Studio Community
    • 1.2 Instalación de SQL Server en Mac
    • 1.3 Extensión Intellicode
    • 1.4 Aplicación de ejemplo
  • 2. Explicación de Conceptos
    • 2.1 Servicios REST
      • 2.1.1 OData
      • 2.1.2 GraphQL
    • 2.2 Entity Framework para versiones de tu base de datos
    • 2.3 Paquetes Nuget
    • 2.4 Archivo de recursos
    • 2.5 Estructura de los Proyectos .Net Core
    • 2.6 Código Limpio
    • 2.7 Programación asíncrona
    • 2.8 Git
    • 2.9 ¿Qué es Scrum?
      • 2.9.1 Personas
      • 2.9.2 Roles Scrum
      • 2.9.3 Backlog
      • 2.9.4 Reuniones del Scrum
  • 3. Control de código fuente y Scrum con Azure DevOps
    • 3.1 Introducción a Azure DevOps
      • 3.1.1 Crear un nuevo Proyecto en Azure DevOps
      • 3.1.2 Agregando personas al equipo de trabajo
      • 3.1.3 Agregando los sprints y la capacidad de trabajo
      • 3.1.4 Crear el Backlog y asignar User Stories al Sprint
      • 3.1.5 Crear Prototipos
      • 3.1.6 Conectar a Azure DevOps desde Visual Studio
        • 3.1.6.1 Crear tu proyecto con Visual Studio Community y sincronizarlo a Azure DevOps
      • 3.1.7 Consultar tus tareas pendientes
        • 3.1.7.1 Tareas y Dashboards con Azure DevOps
        • 3.1.7.2 Consultar tus tareas desde Visual Studio Community
      • 3.1.8 Trabajando con Ramas (Branches)
        • 3.1.8.1 Crear la rama desarrollo desde Azure DevOps
          • 3.1.8.1 Crear una rama(branch) desde tu tarea en Azure DevOps
        • 3.1.8.2 Como trabajar con ramas (branches) desde Visual Studio Community
        • 3.1.8.3 Crear el Pull Request con Azure DevOps
      • 3.1.9 Retrospectiva del Sprint
      • 3.1.10 Agregando una Wiki
    • 3.2 Integrando tu código fuente a GitHub
      • 3.2.1 Trabajando con ramas en GitHub
      • 3.2.2 Sincronizar los cambios del código con GitHub y Visual Studio
      • 3.3 Trabajando con Branches (Ramas) con Visual Studio
        • 3.3.1 Branches con Visual Studio
        • 3.3.2 Creando un template para tus PR (Pull Request)
        • 3.3.3 Protegiendo tu branch
  • 4. Creando tu primer servicio
    • 4.1 Crear las base de datos y los usuarios en MySQL
    • 4.2 Crear la tabla Categoría y sus validaciones
    • 4.3 Creando el servicio Categorias
    • 4.4 Probando tus servicios con POSTMAN
    • 4.5 Documentar y Probar tus servicios con Swagger
      • 4.5.1 Configurar Swagger
      • 4.5.2 Comentarios XML
      • 4.5.3 Generando la página de documentación
    • 4.6 Agregando índices
    • 4.7 Mejorando tu código
      • 4.7.1 Creando Objetos de Accesos a Datos
      • 4.7.2 Creando tus mensajes de error en diferentes idiomas
      • 4.7.3 Cambiando el formato del Json de los servicios
  • 5. Agregando el servicio para los productos
    • 5.1 Crear la tabla de Productos
    • 5.2 Formas de cargar información de tablas relacionadas
    • 5.3 Crear llaves fóraneas e índices
    • 5.4 Creando el servicio Productos
    • 5.5 Validar Reglas Mejorando tu código
      • 5.5.1 Agregando una excepción a todos nuestros servicios
      • 5.5.2 Agregando clases genéricas para validar y/o consultar información
      • 5.5.3 Alternativa para validar reglas con ef core
  • 6. Cambiar de base de datos a SQL Server
    • 6.1 Cambiar la base de datos a SQL Server
    • 6.2 Cambiar a SQL Server en Azure
  • 7. Crear servicios con OData
    • 7.1.1 Creando el modelo Clientes
    • 7.1.2 Creando el modelo ClienteCategoría
    • 7.1.3 Agregando paquete Nuget para OData
    • 7.1.4 Configurar el EDM Model
    • 7.1.5 Configurar el servicio OData y llaves foráneas
    • 7.1.6 Creando el Controller para clientes
    • 7.1.7 Configurar y probar los servicios con OData
    • 7.1.8 Práctica Crear el servicio para ClientesCategorias
    • 7.1.9 Recomendaciones de seguridad y rendimiento a tomar en cuenta con OData
  • 8. GraphQL
    • 8.1.1 Creando la tabla Caducidad
    • 8.1.2 Creando el query
    • 8.1.3 Configurando y probando graphQL
    • 8.1.4 Creando la Mutation
    • 8.1.5 Probando nuestros servicios con Postman
  • 9. Seguridad
    • 9.1 Json Web Tokens
    • 9.2 Seguridad basada en roles y usuarios
      • 9.2.1 Creando nuestra tabla roles e insertando los roles principales
      • 9.2.2 Consideraciones de seguridad para almacenar tus passwords
      • 9.2.3 Creando las tablas para manejar la seguridad
      • 9.2.4 Agregando usuarios y roles
    • 9.3 Agregando seguridad a nuestros servicios
    • 9.4 Creando nuestro servicio de login y generar el token
    • 9.5 ¿Cómo agregar seguridad basada en roles a los Servicios REST?
      • 9.5.1 Seguridad basada en claims
      • 9.5.2 Creando las tablas para validar permisos por cada tabla
      • 9.5.3 Seguridad basada en directivas
      • 9.5.4 Seguridad con Action Filters
    • 9.6 Guardando el historial de cambios
    • 9.7 Refrescando tu token
    • 9.8 Seguridad Mejorando tu código
      • 9.8.1 ¿Cómo limitar el número de intentos incorrectos en el login?
      • 9.8.2 ¿Cómo obtener la ciudad del usuario por medio de la IP?
      • 9.8.3 Habilitando CORS
  • 10. Pruebas Unitarias
    • 10.1 Agregando el proyecto de pruebas unitarias
    • 10.2 Crear una prueba unitaria
      • 10.2.1 Ejecutando las pruebas unitarias
    • 10.3 Agregando una base de datos en memoria para nuestras pruebas unitarias
    • 10.4 Agregando la referencia de nuestro proyecto CaducaRest
      • 10.4.1 Agregando paquetes nuget necesarios
    • 10.5 Configurando Clases para Objetos Sustitutos
      • 10.5.1 Configurando el Contexto para utilizar la base de datos en Memoria
      • 10.5.2 Configurando el objeto para sustituir mensajes de Error por idioma
    • 10.6 Agregando pruebas para las Categorías
  • 11. Integración continua
    • 11.1 ¿Qué es la integración continua?
    • 11.2 Subir tu código fuente a BitBucket
      • 11.2.1 Integración continua y pruebas automáticas con Bitbucket
    • 11.3 Integración continua y pruebas automáticas en Azure DevOps
  • 12. Pruebas de integración
    • 12.1 ¿Qué es SpecFlow?
    • 12.2 Agregando el proyecto de pruebas de integración
    • 12.3 Configurando Specflow
    • 12.4 Creando pruebas para el login
    • 12.5 Agregando las pruebas de Integración a Azure Devops
    • 12.6 Specflow Mejorando tu código
      • 12.6.1 Cambiando las pruebas a español
      • 12.6.2 Pasando tablas a nuestras pruebas
      • 12.6.3 Agregar los passwords como variables de ambiente
      • 12.6.4 Probando con SQLite
      • 12.6.5 Agregando diferentes parámetros con MSTest
      • 12.6.6 Generando el reporte living doc de specflow
  • 13. Integración continua con Postman
    • 13.1 Recomendaciones para probar tus servicios
    • 13.2 Instrucciones básicas para probar con Postman
    • 13.3 Crear colecciones en Postman
    • 13.4 Agregar pruebas a tus servicios
    • 13.5 Crear environments
    • 13.6 Agregando datos de prueba con archivos .csv
    • 13.7 Exportando tus colecciones y ejecutarlas con Newman.
    • 13.8 Agregando las colecciones de postman al pipeline
  • 14. Pruebas de usuario
    • 14.1 Page Object Model
    • 14.2 ¿Qué es Selenium?
      • 14.2.1 Selenium Instrucciones básicas
      • 14.2.2 Agregando el proyecto de pruebas de usuario
    • 14.3 ¿Qué es Cypress?
      • 14.3.1 Cypress Instrucciones básicas
    • 14.4 ¿Qué es Playwright?
      • 14.4.1 Playwright Instrucciones básicas
  • 15. Despliegue Continuo con Azure DevOps y Azure
    • 15.1 Crear un App Service en Azure
    • 15.2 Generando Artifacts en Azure Pipelines
    • 15.3 Generando el Release en Azure Pipelines al App Service de Azure
    • 15.4 Ejecutando las colecciones de Postman después del release
    • 15.5 Agregando las pruebas de usuario en Azure Pipelines
  • 16. Instalación en Windows Server e IIS
    • 16.1 Instalar IIS en Windows Server
    • 16.2 Instalación del ASP.NET Core Module/Hosting Bundle
    • 16.3 Crea el Sitio Web en IIS
  • 17. Instalación en Linux
    • 17.1 Creando una máquina virtual linux en Azure
    • 17.2 Habilitando el acceso remoto
    • 17.3 Configura linux para .Net Core
    • 17.4 Instalando mysql
    • 17.5 Instalando Nginx y configurando tu servicio
    • 17.6 Instalando un certificado SSL gratuito con CertBot
    • 17.7 Agregando diferentes subdominios
  • 18. Docker
Powered by GitBook
On this page
  • Probar el servicio GET para obtener todas las categorías
  • Probar el servicio POST
  • Probar el servicio PUT
  • Probar el servicio GET para obtener una categoría por Id
  • Probar el servicio DELETE
  • Como crear tus pruebas automáticas con Postman

Was this helpful?

  1. 4. Creando tu primer servicio

4.4 Probando tus servicios con POSTMAN

Previous4.3 Creando el servicio CategoriasNext4.5 Documentar y Probar tus servicios con Swagger

Last updated 2 years ago

Was this helpful?

nos permite realizar pruebas sobre los servicios con javascript.

Probar el servicio GET para obtener todas las categorías

  1. Selecciona el método a probar, en este caso probaremos el GET

  2. Teclea la URL a probar ​

  3. Da clic en el botón SEND

  4. Abajo en la pestaña de Body vemos un arreglo vacío ya que aún no agregamos ninguna categoría

Probar el servicio POST

  1. Seleccionar el método POST

  2. Seleccionar la pestaña Body

  3. Seleccionar la opción raw

  4. Seleccionar el tipo JSON (application/json)

  5. Teclear el objeto JSON a agregar

  6. Dar clic en el botón Send

  7. Abajo puedes ver el Status en este caso fue 201 Created y en el Body te regresa el Json de la categoría insertada. Si vuelves a probar el servicio GET, obtendrás la categoría recién creada. Del lado izquierdo en la pestaña History se va guardado la lista de servicios llamados por sí lo deseas volver a llamar.

Puedes probar las validaciones dejando el Json con una clave negativa y el nombre en null.​ Mas adelante explicaré como generar los mensajes en español.

Probar el servicio PUT

Para modificar un registro

  1. Seleccionar el método PUT

  2. Seleccionar la pestaña Body

  3. Seleccionar la opción raw

  4. Seleccionar el tipo JSON (application/json)

  5. Teclear el objeto JSON a agregar

  6. Dar clic en el botón Send

  7. Abajo puedes ver el Status en este caso fue 204 No Content y no regresa ningún valor.

Probar el servicio GET para obtener una categoría por Id

Podemos consultar un registro en particular indicado el Id de la categoría

  1. Seleccionar el método GET

  2. Dar clic en el botón Send

  3. Abajo puedes ver el Status en este caso fue 200 OK y regresa la categoría con el Id 1

Probar el servicio DELETE

  1. Seleccionar el método DELETE

  2. Dar clic en el botón Send

  3. Abajo puedes ver el Status en este caso fue 200 OK y te regresa la categoría que se borró.

Como crear tus pruebas automáticas con Postman

En la sección de Test puedes crear las pruebas para validar que el servicio funcione correctamente. Posteriormente puedes configurar azure devops para que se corran estas pruebas después de cada release de tu aplicación.

Primero crea una nueva colección en Postman. Selecciona el tab Collections luego en New Collection

Agrega un Nombre a tu colección en mi caso será PruebasCategorias y una Descripción

Se tienen diferentes pestañas:

  • Pre-request Scripts: Puedes agregar código javascript que se ejecute antes de la llamada a cada servicio rest. Por ejemplo puedes guardar un log para guardar la fecha actual en la que se ejecuta cada servicio

  • Test: Aquí agregas código javascript para ejecutarse después de cada servicio, por ejemplo si todos los servicios que vas a probar regresan un estatus 200 lo puedes poner aquí en lugar de agregar el código para revisar que cada servicio regrese status 200.

  • Variables: Puedes cambiar o definir valores de variables que necesiten todos tus servicios.

La colección se agrega del lado izquierdo, ahora haz clic en AddRequest

Por lo general para pruebas automáticas, se suele agregar el método que vas a probar, luego los parámetros que necesitas y lo que debe validar el método, en mi caso voy a probar el método GET del servicio Categorias y de momento como solo tengo una categoria voy a probar que regrese 1 Categoria, por lo tanto el nombre es GetCategorias_Id1_Regresa1Categoria, puedes agregar una descripción. Por último da clic en Save to PruebasCategorias

Del lado izquierdo se agrega el método GET da clic y del lado derecha agrega la petición al servicio categorias

http://localhost:5000/api/Categorias/1

Para probar en postman se usa código javascript, puedes ver la documentación oficial

Los test empiezan con pm.test, a continuación teclea la descripción del test entre paréntesis, por ejemplo voy a probar que el servicio regrese un status 200, que es OK. Entonces puedes agregar Status Correcto, luego agrega una función javascript, para poder probar que el status code del servicio es 200 postman cuenta con la instrucción. El código final queda asi:

pm.test("Status Correcto", function() {
    pm.response.to.be.ok;
});

Como ya sabemos que el 1 es analgésicos vamos a acceder al json regresado por el servicio y comprobar que la propiedad nombre sea Analgésicos. Con la función pm.expect puedes comprobar los valores regresados por el servicio y con la función pm.response.json() obtienes un objeto json que tiene como atributos del objeto las propiedades del json, por ejemplo tiene el Nombre, Id, Clave

pm.test("El campo nombre es " + nombre, function() {
    pm.expect(pm.response.json().Nombre).to.equal("Análgesicos");
});

Da clic en la pestaña Test y agrega el siguiente código

pm.test("Status Correcto", function() {
    pm.response.to.be.ok;
});

var nombre = "Análgesicos";

pm.test("El campo nombre es " + nombre, function() {
    pm.expect(pm.response.json().Nombre).to.equal("Análgesicos");
});

Si das clic en el botón Send verás en la petaña Test Results en verde los 2 casos de prueba.

Esta solo fue una breve introducción. Puedes consultar la sección: 13. Integración continua con Postman

Postman tiene opciones interesantes como:

  • Monitorear los servicios cada hora, un día a la semana o todos los días de la semana a una hora

  • Crear workspaces para generar la documentación de tus servicios

  • Convertir la respuesta de tus servicios en gráficas, tablas html y compartirla con los usuarios de tu equipo

  • Flows: Te permite crear flujos de peticiones rest (workflow)

  • Mock Requests: El cual te permite simular un servicio rest

Otra forma de probar y documentar tus servicios es con la extensión de Swagger que instalamos previamente. Swagger ya viene por defecto en la versión .net 6

Teclear la URL ​

Teclear la URL donde 1 es el Id del registro que deseas modificar

Teclear la URL donde 1 es el Id del registro que deseas consultar

Teclear la URL donde 1 es el Id del registro que deseas borrar

Authorization: Permite definir la autorización que utilizan todos los servicios de tu colección, una forma de autorización común en servicios es JWT que se explica en la sección

http://localhost:50685/api/Categorias
http://localhost:50685/api/Categorias/1
http://localhost:50685/api/Categorias/1
http://localhost:50685/api/Categorias/1
Seguridad
Postman
http://localhost:50685/api/Categorias
Test script examplesPostman Learning Center
Logo