requests vs Playwright API【2026년판】｜Python API 테스트는 어느 쪽을 선택해야 할까?

Python으로 API 테스트를 작성할 때 「requests와 Playwright API, 어느 쪽을 써야 할까?」라고 고민하는 QA 엔지니어가 많다. requests는 심플하고 학습 비용이 낮으며, Playwright API는 E2E 테스트와의 통합에 강하다. 이 글에서는 15년 이상의 QA 실무 경험을 바탕으로, 같은 API 테스트를 두 도구로 작성해 비교하면서 실무 목선에서 사용 구분의 판단 기준을 해설한다.

requests는 「API 테스트 전용 경량 도구」, Playwright API는 「E2E+API를 하나의 코드베이스로 관리하는 도구」 — 목적이 다르기 때문에 어느 쪽이 더 낫다는 이야기가 아니다.

이 글의 목표는 「어느 쪽이 더 낫다」를 결론내리는 것이 아니라, 「내 팀·운용에 어느 쪽이 맞는가」를 실무 베이스로 정리하는 것이다.

requests vs Playwright API｜기본 비교

코드로 보는 차이｜같은 테스트를 두 도구로 비교

① GET 요청·기본 어설션

# ✅ requests + pytest
import requests

def test_유저_목록을_가져올_수_있다():
    response = requests.get(
        "https://jsonplaceholder.typicode.com/users",
        timeout=(3, 10)
    )
    assert response.status_code == 200
    users = response.json()
    assert len(users) > 0
    assert "name" in users[0]

# 🎭 Playwright API + pytest
# ※ playwright fixture를 사용하는 경우 pytest-playwright 플러그인이 필요
from playwright.sync_api import Playwright

def test_유저_목록을_가져올_수_있다(playwright: Playwright):
    api = playwright.request.new_context(
        base_url="https://jsonplaceholder.typicode.com"
    )
    response = api.get(
        "/users",
        timeout=10_000  # ms 지정（10초）
        # Playwright에는 기본 30초 타임아웃이 있음. CI 안정화를 위해 명시 지정 권장
    )
    assert response.status == 200
    users = response.json()
    assert len(users) > 0
    assert "name" in users[0]
    # 샘플에서는 간략화를 위해 직접 dispose. 실무에서는 fixture화하여 공통 관리
    api.dispose()

② POST 요청·JSON 바디 전송

# ✅ requests + pytest
import requests

def test_게시글을_생성할_수_있다():
    payload = {
        "title": "자동화 테스트 게시글",
        "body": "Playwright API와 requests 비교",
        "userId": 1
    }
    response = requests.post(
        "https://jsonplaceholder.typicode.com/posts",
        json=payload,
        timeout=(3, 10)
    )
    assert response.status_code == 201
    data = response.json()
    assert data["title"] == payload["title"]
    assert "id" in data

# 🎭 Playwright API + pytest
def test_게시글을_생성할_수_있다(playwright: Playwright):
    api = playwright.request.new_context(
        base_url="https://jsonplaceholder.typicode.com"
    )
    payload = {
        "title": "자동화 테스트 게시글",
        "body": "Playwright API와 requests 비교",
        "userId": 1
    }
    response = api.post(
        "/posts",
        json=payload,
        timeout=10_000  # ms 지정（10초）. 기본 30초 있음, 실무에서는 명시 지정 권장
    )
    assert response.status == 201
    data = response.json()
    assert data["title"] == payload["title"]
    assert "id" in data
    # 샘플에서는 간략화를 위해 직접 dispose. 실무에서는 fixture화하여 공통 관리
    api.dispose()

③ Cookie 인증 요청

# ✅ requests + pytest（Cookie 인증）
import requests
import pytest

BASE_URL = "https://restful-booker.herokuapp.com"

@pytest.fixture(scope="session")
def auth_token() -> str:
    response = requests.post(
        f"{BASE_URL}/auth",
        json={"username": "admin", "password": "password123"},
        timeout=(3, 10)
    )
    response.raise_for_status()  # HTTP 에러를 즉시 감지
    data = response.json()
    assert "token" in data, "인증 응답에 token이 없음"
    return data["token"]

def test_예약을_삭제할_수_있다(auth_token: str):
    headers = {"Cookie": f"token={auth_token}"}
    response = requests.delete(
        f"{BASE_URL}/booking/1",
        headers=headers,
        timeout=(3, 10)
    )
    assert response.status_code in (200, 201)

# 🎭 Playwright API + pytest（Cookie 인증）
import pytest
from playwright.sync_api import Playwright, APIRequestContext

@pytest.fixture(scope="session")
def api_context(playwright: Playwright) -> APIRequestContext:
    # 실무에서는 conftest.py에서 fixture화하여 전체 테스트에서 재사용
    api = playwright.request.new_context(
        base_url="https://restful-booker.herokuapp.com"
    )
    yield api
    api.dispose()

@pytest.fixture(scope="session")
def auth_token(api_context: APIRequestContext) -> str:
    response = api_context.post(
        "/auth",
        json={"username": "admin", "password": "password123"},
        timeout=10_000  # ms 지정（10초）
    )
    assert response.status == 200
    data = response.json()
    assert "token" in data, "인증 응답에 token이 없음"
    return data["token"]

def test_예약을_삭제할_수_있다(api_context: APIRequestContext, auth_token: str):
    response = api_context.delete(
        "/booking/1",
        headers={"Cookie": f"token={auth_token}"},
        timeout=10_000
    )
    assert response.status in (200, 201)

④ Playwright API의 진가｜E2E+API 통합 테스트

# 🎭 Playwright：E2E 테스트와 API 테스트를 하나의 테스트로 통합
from playwright.sync_api import Page, expect

def test_유저_등록_후_API로도_확인할_수_있다(page: Page, playwright):
    # ① UI로 유저 등록（E2E 테스트）
    page.goto("https://example.com/register")
    page.fill("#email", "test@example.com")
    page.fill("#password", "SecurePass123")
    page.click("#register-btn")
    expect(page.get_by_text("등록 완료")).to_be_visible()

    # ② API로 유저가 생성됐는지 확인（API 테스트）
    api = playwright.request.new_context(
        base_url="https://example.com"
    )
    response = api.get("/api/users?email=test@example.com")
    assert response.status == 200
    users = response.json()
    assert len(users) == 1
    assert users[0]["email"] == "test@example.com"
    api.dispose()

    # requests 단독으로는 위의 UI 조작을 다룰 수 없으므로
    # 이런 E2E+API 통합은 Playwright와의 조합이 자연스럽다

requests의 강점과 약점

Playwright API의 강점과 약점

어느 쪽을 선택할까｜판단 흐름

이전 판단 체크리스트｜requests → Playwright API

실무 추천 구성｜Session·fixture·conftest.py

requests.Session()을 사용해야 할 때

import pytest
import requests

BASE_URL = "https://restful-booker.herokuapp.com"

@pytest.fixture(scope="session")
def auth_session() -> requests.Session:
    session = requests.Session()
    # 공통 헤더를 한 번에 설정
    session.headers.update({
        "Content-Type": "application/json",
        "Accept": "application/json"
    })
    # 인증하여 Cookie 취득
    response = session.post(
        f"{BASE_URL}/auth",
        json={"username": "admin", "password": "password123"},
        timeout=(3, 10)
    )
    response.raise_for_status()     # HTTP 에러를 즉시 감지
    data = response.json()
    assert "token" in data, "인증 응답에 token이 없음"
    token = data["token"]
    session.cookies.set("token", token)
    yield session       # yield로 후처리가 실행되도록
    session.close()     # 테스트 종료 후 세션을 확실하게 해제

def test_세션으로_예약_목록_취득(auth_session: requests.Session):
    response = auth_session.get(f"{BASE_URL}/booking", timeout=(3, 10))
    assert response.status_code == 200
    assert len(response.json()) > 0

conftest.py를 사용한 추천 디렉터리 구성

tests/
├── conftest.py          # 공통 fixture（auth_session, api_context 등）
├── api/
│   ├── test_booking.py  # requests 기반 API 테스트
│   └── test_auth.py
└── e2e/
    ├── test_login.py    # Playwright 기반 E2E 테스트
    └── test_booking_ui.py

FAQ｜자주 묻는 질문

# pytest-playwright를 사용하지 않는 최소 구성
from playwright.sync_api import sync_playwright

def test_유저_목록_취득():
    with sync_playwright() as p:
        api = p.request.new_context(
            base_url="https://jsonplaceholder.typicode.com"
        )
        response = api.get("/users", timeout=10_000)
        assert response.status == 200
        api.dispose()

마치며

「어느 쪽이 더 낫다」가 아닌 「내 팀에 무엇이 필요한가」로 선택하는 것이 중요하다. 고민될 때는 이 글의 체크리스트와 판단 흐름을 참고해주시기 바란다.