백엔드 API 설계와 구현 - 요청·응답·상태 코드
이 장에서 배우는 것
앞 장에서 모임과 참가 신청을 별도 테이블에 저장하고, 같은 모임에 같은 이름으로 두 번 신청하지 못하도록 제약 조건을 두었다. 이번에는 그 데이터에 접근하는 창구를 만든다. 다음 장에서 만들 화면은 이 창구를 통해 모임을 읽고 참가 신청을 등록한다. 화면이 없어도 어떤 요청을 보내야 하고 어떤 답을 받는지 확인할 수 있도록, 먼저 응용 프로그램 인터페이스(API)의 약속부터 정한다.
- URL과 메서드를 짝지어 모임 조회와 참가 신청을 구분한다.
- JSON 요청과 응답의 필드를 정하고 오류 응답에 공통 형식을 적용한다.
- 요청 처리 결과에 따라 200, 201, 400, 404, 409를 고른다.
- 서버를 띄우지 않고 요청 처리 함수를 직접 호출해 상태 코드, 응답 내용, 저장 결과를 확인한다.
문제 상황
동네 책 읽기 모임에 참가하려는 지민이 이름을 입력하고 신청 버튼을 누른다. 화면에는 신청이 끝났다는 문구가 떠야 한다. 같은 이름으로 버튼을 다시 누르면 이미 신청했다는 문구가 필요하다. 오래된 공지에서 삭제된 모임 주소로 들어왔을 때는 모임을 찾을 수 없다고 알려야 한다. 세 경우에 서버가 모두 같은 상태 코드와 문장을 보내면 화면은 어떤 일이 일어났는지 안정적으로 구분하기 어렵다.
이름을 비워 둔 신청도 따로 생각해야 한다. 화면에서 빈 칸을 검사하더라도 요청을 만드는 경로가 화면 하나로 고정되지는 않는다. 서버는 전달받은 이름을 직접 검사해야 한다. 또한 이름 검사에 통과했다는 사실과 신청 행이 저장됐다는 사실은 다르다. 성공 응답은 저장이 끝난 뒤에 보낸다. 이렇게 순서를 정해 두면 화면은 응답을 받은 시점에 어떤 내용을 사용자에게 보여 줄지 결정할 수 있다.
URL과 메서드로 요청의 뜻 정하기
URL의 경로는 요청이 가리키는 대상을 나타낸다. 메서드는 그 대상에 어떤 일을 하려는지 나타낸다. 이 사이트는 모임 목록, 모임 하나, 특정 모임의 참가 신청을 각각 경로로 표현한다. {id} 자리에는 앞 장에서 기본 키로 사용한 모임 번호가 들어간다. 예를 들어 /events/1/registrations는 1번 모임의 신청을 가리킨다.
| 메서드 | 경로 | 요청 본문 | 성공 응답 |
|---|---|---|---|
| GET | /events | 없음 | 200, 모임 목록 |
| GET | /events/{id} | 없음 | 200, 해당 모임의 정보 |
| POST | /events/{id}/registrations | 참가자 이름을 담은 JSON 객체 | 201, 저장된 참가 신청 |
목록 조회와 상세 조회는 행을 읽는다. 참가 신청은 행을 추가한다. 이 구분은 같은 요청을 다시 보냈을 때 특히 중요하다. 목록을 두 번 읽어도 신청 행은 생기지 않는다. 신청을 두 번 보내면 첫 요청이 행을 만든 뒤 두 번째 요청은 기존 행과 충돌한다. 예제는 모임 번호를 0으로 시작하지 않는 양의 정수로 받으며, 자릿수는 18자리까지 허용한다. 이 범위 안의 번호만 SQLite에 전달한다. 경로 끝에 슬래시를 붙인 주소도 이 예제에서는 별도 경로로 간주한다.
모임 번호가 들어갈 자리가 비었거나 글자로 채워져 있으면 정의된 자원 경로와 일치하지 않으므로 404를 보낸다. 형식에 맞는 번호를 받았지만 모임 테이블에 해당 행이 없을 때도 404를 보낸다. 두 응답의 오류 코드가 다르므로, 호출하는 쪽은 주소 형식의 문제인지 존재하지 않는 모임의 문제인지 구분할 수 있다. 이 장에서는 표에 없는 메서드와 경로의 조합도 404로 처리한다.
JSON과 상태 코드로 처리 결과 표현하기
참가 신청 본문은 {"name": "지민"} 모양이다. 어느 모임에 신청하는지는 URL에서 이미 드러나므로 본문에는 이름만 넣는다. 서버는 JSON을 해석할 수 있는지, 결과가 객체인지, 이름이 문자열인지 순서대로 확인한다. 문자열 양끝의 공백을 제거한 뒤 길이가 1자 이상 40자 이하인지 검사한다. 따라서 " 지민 "과 "지민"은 같은 모임에서 같은 이름으로 취급된다. 길이는 파이썬 문자열에서 len()으로 센다.
응답의 바깥쪽도 항상 JSON 객체다. 성공하면 data에 결과를 넣고, 실패하면 error에 오류 코드와 안내 문구를 넣는다. 목록 조회의 data는 배열이며, 등록된 모임이 없으면 빈 배열이다. 상세 조회의 data는 id와 title이 들어 있는 객체다. 신청 성공의 data에는 새 신청의 id, 모임 번호인 event_id, 저장한 name이 들어 있다.
실패 응답의 예는 {"error": {"code": "duplicate_registration", "message": "이미 신청한 이름이다."}}다. 화면은 code를 비교해 처리 방법을 고르고, 필요할 때 message를 표시한다. 문구를 다듬어도 화면의 분기 조건은 유지할 수 있다. 한편 상태 코드는 HTTP 응답의 상태에 담는다. 예를 들어 신청이 중복되면 HTTP 응답에 409를 담고, 본문에는 어떤 충돌이 있었는지 설명한다.
| 상태 코드 | 판단 기준 | 예제에서 발생하는 경우 |
|---|---|---|
| 200 | 읽기 요청을 처리했다. | 모임 목록이나 상세 정보를 반환한다. |
| 201 | 새 행을 만들었다. | 참가 신청을 저장하고 신청 번호를 반환한다. |
| 400 | 요청 본문을 수정해야 한다. | JSON을 읽을 수 없거나 이름 규칙을 어겼다. |
| 404 | 요청한 경로나 모임을 찾을 수 없다. | 정의되지 않은 경로를 사용했거나 모임 번호에 해당하는 행이 없다. |
| 409 | 요청과 현재 저장 상태가 충돌한다. | 같은 모임에 같은 이름으로 저장된 신청이 있다. |
신청 요청에서는 본문 검사를 먼저 한다. 본문이 잘못됐고 모임도 없다면 400을 반환한다. 올바른 본문으로 다시 요청하면 모임 유무까지 확인한다. 중복은 신청을 저장하는 시점에 확인한다. 삽입문은 event_id와 name의 조합이 이미 있을 경우에만 새 행을 만들지 않도록 지정한다. 이처럼 실패가 겹칠 때 어느 결과가 먼저 나오는지 정해 두면 확인 코드에도 같은 기대값을 적을 수 있다.
요청 처리와 서버 연결 나누기
요청 처리의 중심은 handle_request()다. 이 함수는 DB 연결, 메서드, 경로, 본문 바이트를 받고 상태 코드와 응답 객체를 돌려준다. 확인 코드에서는 이 함수를 직접 부른다. 서버 실행 분기에서는 웹 서버와 파이썬 애플리케이션을 연결하는 규약(WSGI)에 맞춰 같은 함수를 부른다. 연결 함수는 서버가 전달한 요청 환경에서 필요한 값을 꺼내고, 응답 객체를 UTF-8 JSON 바이트로 바꾼다.
AI에게 작업을 요청할 때는 표에 적은 경로와 상태 코드에 더해, 성공을 판정할 기준까지 전달한다. 아래 표는 초안을 받은 뒤 사람이 수정 사항과 확인 방법을 남기는 예다. 수정 전후 차이(diff)를 볼 때는 상태 코드가 달라진 줄과 DB에 쓰는 줄을 함께 읽는다. 201을 반환하도록 바뀌었더라도 삽입에 실패한 경로에서 같은 응답을 내보낼 수 있다면 계약을 지킨 코드가 아니다.
| AI에게 보낸 요청문 | 초안에서 확인한 내용 | 사람이 고친 부분 | 확인 방법 |
|---|---|---|---|
| 모임을 조회하고 신청을 저장하는 함수를 작성하라. 목록 조회는 200, 신청 생성은 201을 반환하라. | 신청 저장 뒤에도 조회와 같은 200을 반환했다. | 삽입과 커밋이 끝난 분기에서 201과 새 신청 번호를 반환하도록 고쳤다. | 반환 상태와 본문의 번호를 살피고 DB에 저장된 행을 비교한다. |
| 같은 모임의 같은 이름을 409로 처리하라. 중복 판정에는 테이블의 고유 제약을 사용하라. | 삽입하기 전에 이름을 조회했다. 조회와 삽입 사이에 저장 상태가 달라질 수 있었다. | 삽입문에서 고유 제약의 대상 열을 지정하고 삽입된 행 수로 판정하도록 고쳤다. | 수정 전후의 SQL을 비교한다. 공백을 붙인 같은 이름으로 다시 신청해 409와 행 수 1을 확인한다. |
| 실패 응답을 한 가지 모양으로 만들고 서버 없이 요청 처리 함수를 확인하라. | 없는 모임에는 문자열을, 이름 오류에는 객체를 반환했다. | 공통 함수에서 error.code와 error.message를 만들도록 고쳤다. | 잘못된 JSON, 빈 이름, 없는 모임을 각각 전달해 상태와 본문의 구조를 검사한다. |
완성 코드
main.py
아래 파일은 모임 두 건을 메모리 DB에 준비한다. 기본 실행에서는 같은 연결을 사용해 여덟 요청을 확인한 뒤 마지막에 남은 신청 행을 검사한다. --serve 인자를 지정한 경우에만 서버 실행 분기로 들어간다. 두 실행 방식은 각각 새 DB에서 시작한다.
import argparse
import json
import re
import sqlite3
from contextlib import closing
from http import HTTPStatus
from wsgiref.simple_server import make_server
EVENT_PATH = re.compile(r"/events/([1-9][0-9]{0,17})")
REGISTRATION_PATH = re.compile(r"/events/([1-9][0-9]{0,17})/registrations")
def initialize_db(db):
db.row_factory = sqlite3.Row
db.execute("PRAGMA foreign_keys = ON")
db.executescript(
"""
CREATE TABLE events (
id INTEGER PRIMARY KEY,
title TEXT NOT NULL
);
CREATE TABLE registrations (
id INTEGER PRIMARY KEY,
event_id INTEGER NOT NULL REFERENCES events(id),
name TEXT NOT NULL,
UNIQUE (event_id, name)
);
INSERT INTO events (id, title)
VALUES (1, '동네 책 읽기'), (2, '토요일 산책');
"""
)
def error(status, code, message):
return status, {"error": {"code": code, "message": message}}
def find_event(db, event_id):
return db.execute(
"SELECT id, title FROM events WHERE id = ?", (event_id,)
).fetchone()
def event_not_found():
return error(404, "event_not_found", "모임을 찾을 수 없다.")
def invalid_json_constant(value):
raise ValueError(value)
def register(db, event_id, body):
try:
payload = json.loads(
body.decode("utf-8"), parse_constant=invalid_json_constant
)
except (ValueError, RecursionError):
return error(400, "invalid_json", "JSON 본문을 읽을 수 없다.")
raw_name = payload.get("name") if isinstance(payload, dict) else None
name = raw_name.strip() if isinstance(raw_name, str) else ""
if not 1 <= len(name) <= 40:
return error(400, "invalid_name", "이름은 1자 이상 40자 이하여야 한다.")
# JSON 이스케이프로 들어온 짝 없는 서로게이트도 저장 전에 거른다.
try:
name.encode("utf-8")
except UnicodeEncodeError:
return error(400, "invalid_name", "이름에 저장할 수 없는 문자가 있다.")
if find_event(db, event_id) is None:
return event_not_found()
with db:
result = db.execute(
"""
INSERT INTO registrations (event_id, name)
VALUES (?, ?)
ON CONFLICT (event_id, name) DO NOTHING
""",
(event_id, name),
)
if result.rowcount == 0:
return error(409, "duplicate_registration", "이미 신청한 이름이다.")
return 201, {
"data": {"id": result.lastrowid, "event_id": event_id, "name": name}
}
def handle_request(db, method, path, body=b""):
if method == "GET" and path == "/events":
rows = db.execute("SELECT id, title FROM events ORDER BY id")
return 200, {"data": [dict(row) for row in rows]}
if method == "GET" and (match := EVENT_PATH.fullmatch(path)):
event = find_event(db, int(match[1]))
if event is None:
return event_not_found()
return 200, {"data": dict(event)}
if method == "POST" and (match := REGISTRATION_PATH.fullmatch(path)):
return register(db, int(match[1]), body)
return error(404, "route_not_found", "요청한 경로를 찾을 수 없다.")
def make_app(db):
def application(environ, start_response):
method = environ["REQUEST_METHOD"]
path = environ.get("PATH_INFO", "")
length_text = environ.get("CONTENT_LENGTH") or "0"
try:
length = int(length_text)
if length < 0:
raise ValueError
except ValueError:
status, payload = error(
400, "invalid_length", "본문 길이를 읽을 수 없다."
)
else:
body = environ["wsgi.input"].read(length) if length else b""
status, payload = handle_request(db, method, path, body)
response = json.dumps(payload, ensure_ascii=False).encode("utf-8")
start_response(
f"{status} {HTTPStatus(status).phrase}",
[
("Content-Type", "application/json; charset=utf-8"),
("Content-Length", str(len(response))),
],
)
return [response]
return application
def check_requests(db):
name_body = '{"name": " 지민 "}'.encode("utf-8")
same_name_body = '{"name": "지민"}'.encode("utf-8")
cases = [
("GET", "/events", b"", 200, [
{"id": 1, "title": "동네 책 읽기"},
{"id": 2, "title": "토요일 산책"},
]),
("GET", "/events/1", b"", 200, {"id": 1, "title": "동네 책 읽기"}),
("POST", "/events/1/registrations", b"{", 400, "invalid_json"),
("POST", "/events/1/registrations", b'{"name": " "}', 400, "invalid_name"),
("POST", "/events/99/registrations", name_body, 404, "event_not_found"),
("GET", "/events/no-id", b"", 404, "route_not_found"),
("POST", "/events/1/registrations", name_body, 201,
{"id": 1, "event_id": 1, "name": "지민"}),
("POST", "/events/1/registrations", same_name_body, 409,
"duplicate_registration"),
]
for method, path, body, expected_status, expected_value in cases:
status, payload = handle_request(db, method, path, body)
assert status == expected_status, (method, path, status, payload)
if status in (200, 201):
assert payload == {"data": expected_value}, payload
label = "data"
else:
assert set(payload) == {"error"}, payload
assert set(payload["error"]) == {"code", "message"}, payload
assert payload["error"]["code"] == expected_value, payload
message = payload["error"]["message"]
assert isinstance(message, str) and message.strip(), payload
label = expected_value
print(f"{method} {path} -> {status} {label}")
rows = db.execute(
"SELECT id, event_id, name FROM registrations ORDER BY id"
).fetchall()
assert [tuple(row) for row in rows] == [(1, 1, "지민")]
print(f"확인 완료: 요청 {len(cases)}건, 저장된 신청 {len(rows)}건")
def main():
parser = argparse.ArgumentParser()
parser.add_argument("--serve", action="store_true")
args = parser.parse_args()
with closing(sqlite3.connect(":memory:")) as db:
initialize_db(db)
if args.serve:
with make_server("127.0.0.1", 8000, make_app(db)) as server:
server.serve_forever()
else:
check_requests(db)
if __name__ == "__main__":
main()
줄별 해설
EVENT_PATH와REGISTRATION_PATH는 번호를 괄호 안에 따로 잡는다.fullmatch()로 경로 전체를 비교하므로 뒤에 다른 경로 조각이 붙으면 일치하지 않는다.match[1]은 괄호 안에서 잡힌 문자열이다. 숫자 형식과 길이를 확인한 다음에만int()로 바꾼다.initialize_db()의 두 테이블은 모임과 신청의 관계를 재현한다.PRAGMA foreign_keys = ON은 이 연결에서 외래 키 검사를 켠다.UNIQUE (event_id, name)은 모임 번호와 이름의 쌍을 유일하게 유지한다. 따라서 같은 이름도 모임 번호가 다르면 별도로 저장할 수 있다.sqlite3.Row를 사용하므로 조회 결과를 열 이름이 있는 사전으로 바꿀 수 있다.error()의 반환값은 상태 코드와 사전의 쌍이다. 없는 모임에 대한 응답은event_not_found()에 모아 상세 조회와 신청에서 같은 오류 코드와 문구를 쓴다. URL 자체를 찾지 못했을 때는route_not_found를 쓴다.register()는 요청 바이트를 UTF-8로 해석한 뒤 JSON을 읽는다.parse_constant에 넘긴 함수는NaN처럼 JSON에 없는 상수를 거부한다. 잘못된 문자 인코딩과 JSON 문법은ValueError계열로 처리하고, 파서의 재귀 한도를 넘는 중첩은RecursionError로 처리한다. 읽기에 실패하면 이름 검사나 DB 조회로 넘어가지 않는다.payload.get("name")은 최상위 값이 객체일 때만 실행한다. 이름이 없거나 문자열이 아니면 빈 문자열로 처리해 길이 검사에서 걸러낸다.name.encode("utf-8")은 JSON 이스케이프를 통해 읽혔지만 UTF-8 바이트로 표현할 수 없는 문자열도 DB에 보내기 전에 확인한다.find_event()는 원하는 모임 번호를 매개변수로 넘겨 한 행을 조회한다. 행이 없다면fetchone()은None을 반환하며, 신청은 이 지점에서 404로 끝난다. 신청 삽입문에서도 번호와 이름을 물음표 자리에 매개변수로 넘긴다.ON CONFLICT (event_id, name) DO NOTHING은 지정한 두 열의 고유 제약 충돌에 적용된다. 신청을 썼으면rowcount가 1이고, 해당 충돌로 건너뛰었으면 0이다.with db:를 정상적으로 빠져나올 때 변경을 커밋한다. 예외가 발생하면 변경을 되돌린다. 블록을 지난 뒤 삽입 여부를 판단하므로 201 응답은 저장이 끝난 경우에만 만들어진다.handle_request()는 메서드와 경로를 비교해 세 동작 중 하나를 고른다. 목록 조회에 붙인ORDER BY id는 결과를 모임 번호순으로 정한다. 화면이 이 순서에 맞춰 모임을 표시할 수 있고, 확인 코드도 두 모임의 순서를 고정된 값과 비교할 수 있다.make_app()안의application()은 서버에서 받은 요청 메서드와 경로, 길이를 이용해 처리 함수를 호출한다. 응답은 JSON 문자열을 UTF-8로 인코딩한 후 바이트 길이를 헤더에 넣는다. 한글이 들어간 응답에서는 문자열의 글자 수와 바이트 수가 다르다.start_response()에 상태와 헤더를 전달한 뒤 본문 바이트를 리스트에 담아 반환한다.check_requests()의 각 항목은 요청에 넣을 값과 기대값을 함께 담는다. 성공은data전체를 비교하고, 실패는 바깥과 안쪽의 키, 오류 코드, 문구의 존재를 검사한다. 마지막에는 신청 테이블에서 남은 행을 읽어 성공 요청의 결과만 저장됐는지 확인한다.closing()은 실행 분기를 빠져나갈 때 연결을 닫는다.
실행 결과
터미널에서 파일을 저장한 디렉터리로 이동한 뒤 다음 명령을 실행한다.
python3 main.py
예상 출력은 다음과 같다. 각 줄은 해당 요청의 상태와 응답 구조를 확인한 뒤에 출력된다. 마지막 줄은 여덟 요청이 끝난 시점의 DB 검사까지 통과했음을 뜻한다.
GET /events -> 200 data
GET /events/1 -> 200 data
POST /events/1/registrations -> 400 invalid_json
POST /events/1/registrations -> 400 invalid_name
POST /events/99/registrations -> 404 event_not_found
GET /events/no-id -> 404 route_not_found
POST /events/1/registrations -> 201 data
POST /events/1/registrations -> 409 duplicate_registration
확인 완료: 요청 8건, 저장된 신청 1건
서버 분기를 선택하는 명령은 다음과 같다. 이때는 로컬 주소에서 요청을 기다리며, 터미널에서 Ctrl+C를 누르면 종료된다. 위 출력은 기본 실행에서 나온다.
python3 main.py --serve
실무에서 자주 틀리는 것
아래 코드는 완성 파일에 등장하는 값과 함수를 사용한 교체 예다. 각 사례에서 수정 전후에 어떤 요청의 결과가 달라지는지 함께 살핀다.
신청을 저장하고 조회와 같은 상태를 반환한다
틀린 코드는 새 행을 저장한 분기에도 200을 반환한다. 이렇게 하면 신청이 생성됐다는 사실이 이 API에서 정한 상태 코드에 드러나지 않는다.
return 200, {
"data": {"id": result.lastrowid, "event_id": event_id, "name": name}
}
고친 코드는 저장된 행을 표현하는 응답과 함께 201을 반환한다. 확인 코드에서 신청 성공의 기대값을 201로 두면 이 차이를 잡을 수 있다.
return 201, {
"data": {"id": result.lastrowid, "event_id": event_id, "name": name}
}
이름을 읽기 전에 JSON의 모양을 확인하지 않는다
틀린 코드는 []처럼 문법에 맞는 JSON을 받아도 예외를 일으킨다. 배열에는 get() 메서드가 없기 때문이다. 객체 안에서 이름이 숫자인 경우에도 strip() 호출이 실패한다.
name = payload.get("name", "").strip()
고친 코드는 먼저 객체에서만 값을 꺼내고 문자열에서만 공백을 제거한다. 이름을 얻지 못한 경우에는 뒤의 길이 검사가 공통 오류 응답을 만든다.
raw_name = payload.get("name") if isinstance(payload, dict) else None
name = raw_name.strip() if isinstance(raw_name, str) else ""
삽입이 없었는데 새 신청 번호를 읽는다
틀린 코드는 삽입 결과의 행 수를 확인하기 전에 성공 응답을 반환한다. 중복으로 삽입을 건너뛰어도 201이 나가므로 화면은 존재하지 않는 새 신청을 표시할 수 있다.
return 201, {
"data": {"id": result.lastrowid, "event_id": event_id, "name": name}
}
고친 코드는 중복 분기에서 먼저 빠져나온다. 새 신청 번호는 나머지 분기에서만 사용한다.
if result.rowcount == 0:
return error(409, "duplicate_registration", "이미 신청한 이름이다.")
return 201, {
"data": {"id": result.lastrowid, "event_id": event_id, "name": name}
}
응답 본문의 글자 수를 헤더에 적는다
틀린 코드는 문자열의 길이를 본문의 길이로 전달한다. 한글을 포함한 JSON을 UTF-8로 보내면 서버가 보내는 바이트 수와 헤더 값이 어긋난다.
response_text = json.dumps(payload, ensure_ascii=False)
length_header = ("Content-Length", str(len(response_text)))
response = response_text.encode("utf-8")
고친 코드는 전송할 바이트를 먼저 만들고 그 길이를 헤더에 넣는다.
response = json.dumps(payload, ensure_ascii=False).encode("utf-8")
length_header = ("Content-Length", str(len(response)))
한눈에 보기
| 항목 | 이 장에서 정한 방식 | 확인할 결과 |
|---|---|---|
| 경로와 메서드 | 조회는 GET, 신청 생성은 POST로 표현한다. | 정해진 경로와 메서드 조합에서만 동작한다. |
| 필수 입력 | 신청 본문은 이름 문자열을 담은 JSON 객체다. | 공백을 정리한 이름이 1자 이상 40자 이하이며, 잘못된 본문은 400을 받는다. |
| 저장 결과 | 저장했다면 201, 같은 모임의 이름과 충돌했다면 409를 보낸다. | 201의 신청 번호와 저장된 행이 일치하고, 중복 요청 뒤에도 행 수가 유지된다. |
| 오류 형식 | error.code와 error.message를 공통으로 제공한다. | 화면이 오류 종류를 구분하고 안내 문구를 표시할 수 있다. |
| 확인 경로 | 기본 실행에서 요청 처리 함수를 직접 호출한다. | 서버를 띄우지 않고 응답과 DB 변경을 확인한 뒤 종료한다. |
다음 장에서는 모임 목록과 상세 정보를 화면에 표시하고, 참가 신청의 성공과 실패를 사용자에게 보여 준다. 이번 장에서 고정한 필드 이름과 오류 코드는 그 화면이 전달받은 데이터를 해석하는 기준이 된다.
연습 문제
- 같은 DB 연결에서
GET /events/99를 호출한다. 이어서POST /events/99/registrations에 본문{를 전달한다. 각 요청의 상태와 오류 코드를 예상하고 확인한다. - 현재 확인 목록에서 1번 모임의 중복 신청 다음에 2번 모임에 지민이 신청하는 사례를 추가한다. 기대 응답을 적고, DB를 확인하는 마지막 단언문과 출력의 마지막 줄이 어떻게 바뀌는지 설명한다.
- 이름이 40자인 경우와 41자인 경우를 확인 목록에 추가하려 한다. 공백 제거가 먼저 일어나는지도 확인하도록 40자 사례를 구성한다. 어느 값으로 성공과 실패를 구분할지 적는다.
정답과 해설
GET /events/99는 404와event_not_found를 반환한다. 경로는 상세 조회와 일치하지만 모임 행이 없다. 본문이{인 POST는 400과invalid_json을 반환한다. 신청 함수는 모임을 조회하기 전에 JSON 문법을 검사한다.POST /events/2/registrations에same_name_body를 전달하면 201과{"data": {"id": 2, "event_id": 2, "name": "지민"}}이 돌아온다. 고유 제약은 모임 번호와 이름을 함께 비교한다. 마지막 단언문의 기대값을[(1, 1, "지민"), (2, 2, "지민")]으로 바꾸면 두 행을 확인할 수 있다. 출력의 마지막 줄은확인 완료: 요청 9건, 저장된 신청 2건이다.- 빈 메모리 DB에 모임을 준비한 뒤 1번 모임에
" " + "가" * 40 + " "으로 만든 이름을 보낸다. 이 이름은 앞뒤 공백을 제거하면 40자이므로 201을 받고,data.name에는 공백이 빠진 40자가 들어 있다. 이어서"가" * 41로 만든 이름을 보내면 400과invalid_name을 받는다. 두 요청 뒤에 신청 행이 한 건인지 확인하면 길이 검사에서 실패한 요청이 저장되지 않았다는 점까지 확인할 수 있다.