¿Es posible hacer pruebas de API con Cypress? Guía 2026

La mayoría de desarrolladores cree que Cypress solo sirve para hacer clic en botones y rellenar formularios. No es así. Cypress puede testear toda tu capa de API: peticiones, respuestas, cabeceras, códigos de estado e incluso tráfico de red simulado. Si trabajas en QA o en desarrollo backend en 2026, esta es una habilidad que necesitas dominar.

Sí, Cypress Puede Hacer Pruebas de API

• cy.request() — realiza llamadas HTTP directas a tu API, completamente independientes de la interfaz del navegador. Piensa en ello como un cliente HTTP con scripts dentro de tu suite de tests.
• cy.intercept() — se sitúa entre tu frontend y tu backend, permitiéndote espiar, validar, modificar o reemplazar completamente cualquier petición de red que haga tu aplicación.

cy.request() — Pruebas Directas de API

// Petición GET básica
cy.request('GET', '/api/usuarios').then((response) => {
  expect(response.status).to.eq(200)
  expect(response.body).to.have.length.greaterThan(0)
})

// POST con cuerpo y cabeceras
cy.request({
  method: 'POST',
  url: '/api/usuarios',
  headers: {
    'Content-Type': 'application/json',
    'Authorization': 'Bearer mi-token'
  },
  body: {
    nombre: 'María García',
    email: '[email protected]'
  }
}).then((response) => {
  expect(response.status).to.eq(201)
  expect(response.body).to.have.property('id')
  expect(response.body.email).to.eq('[email protected]')
})

// DELETE y verificar 204
cy.request('DELETE', '/api/usuarios/1').its('status').should('eq', 204)

• response.status — código de estado HTTP
• response.body — cuerpo de la respuesta parseado (JSON se parsea automáticamente)
• response.headers — cabeceras de la respuesta
• response.duration — tiempo que tardó la petición
• response.requestHeaders — las cabeceras que se enviaron

cy.intercept() — Interceptación y Simulación de Red

// Espiar una petición y validar después
cy.intercept('GET', '/api/productos').as('obtenerProductos')
cy.visit('/productos')
cy.wait('@obtenerProductos').then(({ request, response }) => {
  expect(response.statusCode).to.eq(200)
  expect(response.body).to.be.an('array')
})

// Simular respuesta con datos de fixture
cy.intercept('GET', '/api/usuarios', { fixture: 'usuarios.json' }).as('obtenerUsuarios')
cy.visit('/panel')
cy.wait('@obtenerUsuarios')
cy.get('[data-testid="lista-usuarios"]').should('have.length', 3)

// Simular un estado de error
cy.intercept('POST', '/api/pedidos', {
  statusCode: 500,
  body: { error: 'Error interno del servidor' }
}).as('pedidoFallido')
cy.visit('/checkout')
cy.get('[data-testid="confirmar-pedido"]').click()
cy.wait('@pedidoFallido')
cy.get('[data-testid="mensaje-error"]').should('be.visible')

// Modificar una respuesta al vuelo
cy.intercept('GET', '/api/config', (req) => {
  req.reply((res) => {
    res.body.featureFlag = true
    return res
  })
})

Qué Puedes Testear con las Pruebas de API de Cypress

Cypress vs Otras Herramientas de Pruebas de API

Patrones Habituales en Proyectos QA Reales

beforeEach(() => {
  cy.request('POST', '/api/test/resetear-bd')
  cy.request('POST', '/api/usuarios', { nombre: 'Usuario Test', email: '[email protected]' })
})

// Mucho más rápido que escribir en el formulario en cada test
cy.request('POST', '/api/auth/login', {
  email: '[email protected]',
  contrasena: 'contrasena123'
}).then(({ body }) => {
  window.localStorage.setItem('token', body.token)
})
cy.visit('/panel')

cy.intercept('GET', '/api/datos', (req) => {
  req.reply({ delay: 2000, body: [] })
})
cy.visit('/pagina')
cy.get('[data-testid="skeleton-carga"]').should('be.visible')

cy.intercept('POST', '/api/checkout').as('checkout')
cy.get('[data-testid="comprar-ahora"]').click()
cy.wait('@checkout').its('request.body').should('deep.include', {
  productoId: 'abc-123',
  cantidad: 1
})

Pruebas de API con Cypress y la Carrera en QA

Empieza a Desarrollar Habilidades Reales de Backend y QA

Preguntas Frecuentes