Cypress ile API Testi Nasıl Yapılır? 2026 Rehberi

Çoğu geliştirici Cypress'i sadece buton tıklamak ve form doldurmak için kullanır. Oysa Cypress, tüm API katmanını test edebilir; istek gövdelerini, yanıt kodlarını, başlıkları ve ağ trafiğini doğrulayabilirsiniz. 2026'da QA veya backend alanında çalışıyorsanız bu yetkinliği mutlaka öğrenmelisiniz.

Cypress ile API Testi Yapılabilir mi?

• cy.request() — API'nize doğrudan HTTP çağrısı yapar. Tarayıcı arayüzünden bağımsız olarak çalışır; test suit'inizin içindeki bir HTTP istemcisi gibi düşünebilirsiniz.
• cy.intercept() — frontend'iniz ile backend'iniz arasına girerek uygulamanızın yaptığı her ağ isteğini dinlemenizi, üzerinde doğrulama yapmanızı, değiştirmenizi veya tamamen stub'lamanızı sağlar.

cy.request() ile Doğrudan API Testi

// Temel GET isteği
cy.request('GET', '/api/kullanicilar').then((response) => {
  expect(response.status).to.eq(200)
  expect(response.body).to.have.length.greaterThan(0)
})

// Gövde ve başlıklarla POST isteği
cy.request({
  method: 'POST',
  url: '/api/kullanicilar',
  headers: {
    'Content-Type': 'application/json',
    'Authorization': 'Bearer token-degerim'
  },
  body: {
    ad: 'Ayşe Yılmaz',
    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 ve 204 doğrulaması
cy.request('DELETE', '/api/kullanicilar/1').its('status').should('eq', 204)

• response.status — HTTP durum kodu
• response.body — parse edilmiş yanıt gövdesi (JSON otomatik parse edilir)
• response.headers — yanıt başlıkları
• response.duration — isteğin süresi
• response.requestHeaders — gönderilen istek başlıkları

cy.intercept() ile Ağ İsteklerini Yakalama ve Stub'lama

// İstek üzerinde dinleme ve doğrulama
cy.intercept('GET', '/api/urunler').as('urunleriGetir')
cy.visit('/urunler')
cy.wait('@urunleriGetir').then(({ request, response }) => {
  expect(response.statusCode).to.eq(200)
  expect(response.body).to.be.an('array')
})

// Fixture verisiyle yanıtı stub'lama
cy.intercept('GET', '/api/kullanicilar', { fixture: 'kullanicilar.json' }).as('kullanicilariGetir')
cy.visit('/panel')
cy.wait('@kullanicilariGetir')
cy.get('[data-testid="kullanici-listesi"]').should('have.length', 3)

// Hata durumunu simüle etme
cy.intercept('POST', '/api/siparisler', {
  statusCode: 500,
  body: { hata: 'Sunucu hatası' }
}).as('basarisizSiparis')
cy.visit('/odeme')
cy.get('[data-testid="siparis-ver"]').click()
cy.wait('@basarisizSiparis')
cy.get('[data-testid="hata-mesaji"]').should('be.visible')

Cypress API Testiyle Neler Test Edebilirsiniz?

Cypress ile Diğer API Test Araçlarının Karşılaştırması

Gerçek QA Projelerinde Yaygın Kullanım Kalıpları

beforeEach(() => {
  cy.request('POST', '/api/test/veritabani-sifirla')
  cy.request('POST', '/api/kullanicilar', { ad: 'Test Kullanıcı', email: '[email protected]' })
})

// Her testte form doldurmaktan çok daha hızlı
cy.request('POST', '/api/auth/giris', {
  email: '[email protected]',
  sifre: 'sifre123'
}).then(({ body }) => {
  window.localStorage.setItem('token', body.token)
})
cy.visit('/panel')

cy.intercept('GET', '/api/veri', (req) => {
  req.reply({ delay: 2000, body: [] })
})
cy.visit('/sayfa')
cy.get('[data-testid="yukleniyor-iskeleti"]').should('be.visible')

Cypress API Testi ve QA Kariyer Yolu

Gerçek Backend ve QA Becerilerini Geliştirmeye Başla

Sıkça Sorulan Sorular