ProtocolCodes

1. 개요2. 지원 프로토콜

2.1. HTTP2.2. SMTP2.3. gRPC2.4. DNS2.5. WebSocket2.6. FTP2.7. SIP

3. 가이드 시리즈

3.1. HTTP Fundamentals (14편)3.2. API Design & Best Practices (14편)3.3. Security & Authentication (14편)3.4. Debugging & Troubleshooting (14편)3.5. Error Handling Patterns (12편)3.6. Framework Cookbooks (12편)3.7. Performance & Optimization (12편)3.8. Production Infrastructure (12편)3.9. Email Delivery (10편)3.10. DNS & Networking (10편)3.11. Real-Time Protocols (10편)3.12. Protocol Deep Dives (10편)3.13. API Gateway Patterns (10편)3.14. Migration & Upgrades (8편)3.15. Testing & Mocking (10편)

4. 상태 코드 비교

4.1. HTTP 동일 프로토콜 비교 (14쌍)4.2. 크로스 프로토콜 비교 (13쌍)4.3. SIP · SMTP · FTP · DNS 비교

5. 에러 시나리오6. 사양 문서7. 의사결정 트리8. 용어사전9. 개발자 도구

9.1. HTTP Header Checker9.2. Status Code Tester9.3. Mock Response Generator9.4. API Response Mock9.5. Redirect Tracer9.6. JWT Decoder9.7. CORS Checker

10. 다국어 지원11. 유사 서비스와의 비교12. 관련 항목13. 외부 링크

1. 개요

ProtocolCodes(프로토콜코즈)는 HTTP, SMTP, gRPC, DNS, WebSocket, FTP, SIP 등 7개 주요 네트워크 프로토콜의 상태 코드를 통합 정리한 웹 기반 레퍼런스 서비스이다.

<rowcolor=#fff> ProtocolCodes

protocolcodes.com

유형

기술 레퍼런스 사이트

언어

15개 언어 지원

분야

네트워크 프로토콜 상태 코드

콘텐츠

300+ 상태 코드, 172편 가이드, 70개 시나리오

단순히 상태 코드 번호와 의미만 나열하는 것이 아니라, 각 코드가 언제 발생하는지, 어떻게 해결하는지, 다른 프로토콜의 유사한 코드와 어떤 차이가 있는지를 체계적으로 설명하는 것이 특징이다. 172편의 기술 가이드, 70개의 에러 시나리오 해결 가이드, 51개의 RFC 사양 해설, 12개의 인터랙티브 의사결정 트리 등을 제공한다.

2. 지원 프로토콜

7개 프로토콜의 상태 코드를 다루며, 각 프로토콜별로 코드의 의미, 발생 상황, 해결 방법, 코드 예시 등을 제공한다. 전체 상태 코드 목록에서 7개 프로토콜의 모든 코드를 한눈에 비교할 수 있다.

2.1. HTTP

HTTP 상태 코드 섹션에서는 HTTP 프로토콜의 62개 이상의 공식 상태 코드를 다룬다. RFC 9110에 정의된 표준 코드부터 비공식 코드까지 포함한다.

분류	범위	주요 코드 예시	설명
1xx 정보	100–103	100 Continue, 101 Switching Protocols	요청을 수신하여 처리 중
2xx 성공	200–226	200 OK, 201 Created, 204 No Content	요청이 성공적으로 처리됨
3xx 리다이렉트	300–308	301 Moved Permanently, 302 Found, 304 Not Modified	추가 동작이 필요함
4xx 클라이언트 에러	400–451	400 Bad Request, 401 Unauthorized, 403 Forbidden, 404 Not Found, 429 Too Many Requests	클라이언트 측 오류
5xx 서버 에러	500–511	500 Internal Server Error, 502 Bad Gateway, 503 Service Unavailable, 504 Gateway Timeout	서버 측 오류

2.2. SMTP

SMTP 응답 코드 섹션에서는 이메일 전송 프로토콜의 응답 코드를 다룬다. RFC 5321에 정의되어 있으며, 이메일 발송 실패 원인을 진단할 때 필수적인 참조 자료이다.

범위	의미	주요 코드
2xx	명령 완료	250 OK
3xx	추가 입력 필요	354 Start Mail Input
4xx	일시적 실패	421 Service Unavailable, 450 Mailbox Unavailable
5xx	영구적 실패	530 Authentication Required, 550 Mailbox Not Found, 554 Transaction Failed

2.3. gRPC

gRPC 상태 코드 섹션에서는 구글이 개발한 RPC 프레임워크인 gRPC의 17개 상태 코드를 다룬다. HTTP와 달리 숫자가 아닌 이름 기반 코드 체계를 사용한다.

코드	이름	대응 HTTP 코드
0	OK	200 OK
3	INVALID_ARGUMENT	400 Bad Request
5	NOT_FOUND	404 Not Found
7	PERMISSION_DENIED	403 Forbidden
13	INTERNAL	500 Internal Server Error
14	UNAVAILABLE	503 Service Unavailable
16	UNAUTHENTICATED	401 Unauthorized

2.4. DNS

DNS 응답 코드 섹션에서는 도메인 이름 시스템의 RCODE(응답 코드)를 다룬다. RFC 1035에 정의되어 있으며, 도메인 이름 해석 실패 시 원인 파악에 사용된다.

RCODE	이름	의미
0	NOERROR	정상 응답
2	SERVFAIL	서버 오류
3	NXDOMAIN	도메인 없음
5	REFUSED	쿼리 거부

2.5. WebSocket

WebSocket 종료 코드 섹션에서는 웹소켓 연결 종료 시 사용되는 코드를 다룬다. RFC 6455에 정의되어 있으며, 양방향 실시간 통신에서 연결이 끊어진 이유를 진단할 때 참조한다.

코드	이름	의미
1000	Normal Closure	정상 종료
1001	Going Away	엔드포인트 이동
1006	Abnormal Closure	비정상 종료
1008	Policy Violation	정책 위반
1011	Internal Error	서버 내부 오류

2.6. FTP

FTP 응답 코드 섹션에서는 파일 전송 프로토콜의 45개 응답 코드를 다룬다. RFC 959에 정의되어 있다.

범위	의미	주요 코드
1xx	긍정적 예비 응답	150 파일 상태 확인
2xx	긍정적 완료	220 Service Ready, 226 Transfer Complete, 227 Passive Mode
3xx	긍정적 중간 응답	331 Password Required
4xx	일시적 부정	421 Service Not Available, 425 Can't Open Connection
5xx	영구적 부정	530 Not Logged In, 550 File Unavailable

2.7. SIP

SIP 응답 코드 섹션에서는 세션 개시 프로토콜의 66개 응답 코드를 다룬다. VoIP 통화 설정 과정에서 발생하는 각종 상태를 나타내며, RFC 3261에 정의되어 있다.

범위	의미	주요 코드
1xx	임시 응답	100 Trying, 180 Ringing
2xx	성공	200 OK
3xx	리다이렉션	302 Moved Temporarily
4xx	클라이언트 에러	401 Unauthorized, 486 Busy Here
5xx	서버 에러	503 Service Unavailable
6xx	글로벌 에러	600 Busy Everywhere, 603 Decline

3. 가이드 시리즈

기술 가이드 섹션에서는 15개 시리즈, 총 172편의 심층 가이드를 제공한다. 각 가이드는 개념 설명, 코드 예시, 실무 팁, 관련 RFC 참조 등을 포함한다.

3.1. HTTP Fundamentals (14편)

HTTP 프로토콜의 핵심 개념을 다루는 입문 시리즈. 상태 코드 체계부터 HTTP/2, HTTP/3의 변화까지 포괄한다.

[전체 가이드 목록 (14편)]

||<tablewidth=100%> # || 가이드 || 주요 내용 ||

1	HTTP 상태 코드 완벽 가이드	1xx~5xx 다섯 개 클래스의 의미와 활용
2	HTTP 리다이렉트: 301 vs 302 vs 307 vs 308	리다이렉트 유형별 차이와 SEO 영향
3	HTTP 캐싱: Cache-Control, ETag, 304	캐시 전략 설계
4	HTTP 메서드 완벽 가이드	GET, POST, PUT, PATCH, DELETE 사용법
5	필수 HTTP 헤더 가이드	개발자가 알아야 할 핵심 HTTP 헤더
6	HTTP/2 vs HTTP/3: 무엇이 달라졌나	QUIC 프로토콜과 HTTP/3의 변화
7	HTTP 콘텐츠 협상	Accept 헤더 기반 응답 형식 결정
8	HTTP 범위 요청과 부분 콘텐츠	대용량 파일 다운로드 재개 원리
9	HTTP 쿠키: SameSite, Secure, HttpOnly	쿠키 보안 속성 설정
10	HTTP 요청 생명주기	URL 입력부터 응답 수신까지의 전체 과정
11	HTTP 프록시 헤더	X-Forwarded-For, Via, Forwarded 헤더
12	HTTP 조건부 요청	If-Match, If-None-Match 활용
13	HTTP 103 Early Hints	응답 전 리소스 사전 로딩
14	HTTP 트레일러	본문 이후 메타데이터 전송

3.2. API Design & Best Practices (14편)

REST API 설계 시 자주 마주치는 문제들 — 버저닝, 페이지네이션, 에러 응답 형식, Rate Limiting 등을 다루는 시리즈.

[전체 가이드 목록 (14편)]

||<tablewidth=100%> # || 가이드 || 주요 내용 ||

1	REST API를 위한 HTTP 상태 코드 선택	API 응답에 적절한 코드 선택 기준
2	gRPC 상태 코드 실전 가이드	gRPC 에러 코드 활용
3	Rate Limiting 구현과 429 처리	Rate Limiting 알고리즘과 클라이언트 대응
4	API 버저닝 전략: URL, 헤더, 쿼리	API 하위 호환성 유지 방법
5	일관된 API 에러 응답 설계	표준화된 에러 응답 포맷
6	API 페이지네이션 패턴	Offset, Cursor, Keyset 방식 비교
7	Webhook 구현 가이드	이벤트 기반 API 통합
8	GraphQL vs REST: 선택 기준	GraphQL과 REST API 비교
9	OpenAPI 사양으로 API 설계	Swagger 기반 Design-First 개발
10	API 버저닝 전략: URI, 헤더, 미디어 타입	버저닝 패턴별 장단점
11	멱등성 API 설계	안전한 재시도를 위한 멱등 API 설계
12	Bulk API 설계: 배치 요청과 부분 실패	대량 작업 API 패턴
13	API 폐기 전략: Sunset 헤더와 마이그레이션	API 버전 수명 관리
14	HATEOAS와 하이퍼미디어 API	REST 성숙도 모델 Level 3

3.3. Security & Authentication (14편)

웹 보안, 인증, 인가와 관련된 시리즈. OAuth, JWT, CORS, HTTPS 보안 헤더 등을 다룬다.

[전체 가이드 목록 (14편)]

||<tablewidth=100%> # || 가이드 || 주요 내용 ||

1	401 vs 403: 언제 어떤 코드를 사용할 것인가	인증과 인가 구분
2	OAuth 2.0 플로우 해설	Authorization Code, Client Credentials, PKCE
3	JWT: 구조, 서명, 함정	JSON Web Token 심층 분석
4	API Key vs OAuth vs JWT	인증 방식 선택 기준
5	필수 HTTP 보안 헤더	HSTS, CSP, X-Frame-Options 등
6	CORS 설정 완벽 가이드	교차 출처 리소스 공유 설정
7	상호 TLS(mTLS) 구현	클라이언트 인증서 기반 보안
8	API 보안 체크리스트	OWASP API Top 10 대응
9	Content Security Policy(CSP) 구현	XSS 방어를 위한 CSP 정책
10	HSTS 완벽 가이드	HTTPS 강제 전환 정책
11	OAuth 2.0 PKCE: SPA·모바일·CLI용	공개 클라이언트를 위한 보안 강화
12	보안 관점의 Rate Limiting	브루트포스, DDoS 방어
13	API 인증 패턴	Bearer Token, API Key, Session Cookie
14	서브리소스 무결성(SRI)	CDN 호스팅 스크립트 보호

3.4. Debugging & Troubleshooting (14편)

실제 운영 환경에서 자주 발생하는 에러를 체계적으로 디버깅하는 방법을 다루는 시리즈.

[전체 가이드 목록 (14편)]

||<tablewidth=100%> # || 가이드 || 주요 내용 ||

1	502 Bad Gateway 디버깅	리버스 프록시 뒤에서 발생하는 502 해결
2	CORS 에러 디버깅	CORS 오류 원인 분석과 해결
3	타임아웃 에러 디버깅: 408과 504	요청·게이트웨이 타임아웃 해결
4	503 Service Unavailable 디버깅	서비스 과부하·유지보수 상황 대응
5	TLS/SSL 인증서 트러블슈팅	인증서 관련 에러 해결
6	DNS 트러블슈팅: dig과 nslookup	DNS 문제 진단 단계별 가이드
7	429 Too Many Requests 디버깅	Rate Limiting 에러 대응
8	Connection Reset 에러 디버깅	TCP 연결 리셋 원인 분석
9	WebSocket 연결 끊김 디버깅	웹소켓 비정상 종료 해결
10	gRPC 에러 디버깅	gRPC 상태 코드별 해결 방법
11	500 Internal Server Error 체계적 디버깅	서버 에러 근본 원인 추적
12	리다이렉트 루프 디버깅	ERR_TOO_MANY_REDIRECTS 해결
13	Mixed Content 에러 디버깅	HTTPS 페이지의 HTTP 리소스 문제
14	SMTP 전송 실패 디버깅	이메일 4xx 임시 vs 5xx 영구 오류

3.5. Error Handling Patterns (12편)

마이크로서비스 아키텍처에서 에러를 다루는 설계 패턴을 다루는 시리즈. 서킷 브레이커, 재시도, 멱등성 키 등의 패턴을 설명한다.

[전체 가이드 목록 (12편)]

||<tablewidth=100%> # || 가이드 || 주요 내용 ||

1	지수 백오프 재시도 구현	재시도 간격 전략과 지터
2	서킷 브레이커 패턴	회로 차단기 패턴으로 연쇄 장애 방지
3	RFC 9457 Problem Details	표준화된 에러 응답 포맷
4	그레이스풀 디그레이데이션	분산 시스템 점진적 기능 축소
5	타임아웃 버짓 패턴	마이크로서비스 간 타임아웃 할당
6	Dead Letter Queue	비동기 에러 처리와 메시지 큐
7	멱등성 키로 안전한 API 재시도	중복 요청 방지 설계
8	헬스 체크 엔드포인트 설계	로드 밸런서 연동 건강 검진
9	벌크헤드 패턴: 장애 격리	자원 격리로 전체 장애 방지
10	Saga 패턴: 분산 트랜잭션	보상 액션 기반 분산 트랜잭션
11	에러 버짓과 SLO	SRE 관점의 에러 허용 기준
12	폴백 전략 가이드	기본값, 캐시 응답, 기능 축소 모드

3.6. Framework Cookbooks (12편)

주요 웹 프레임워크별로 상태 코드와 에러 처리를 구현하는 방법을 다루는 시리즈. 프레임워크 공식 패턴에 맞는 코드 예시를 제공한다.

[전체 가이드 목록 (12편)]

||<tablewidth=100%> # || 프레임워크 || 가이드 ||

3.7. Performance & Optimization (12편)

웹 성능 최적화와 관련된 시리즈. CDN, HTTP 압축, TTFB, 로드 밸런싱 전략 등을 다룬다.

[전체 가이드 목록 (12편)]

||<tablewidth=100%> # || 가이드 || 주요 내용 ||

1	API를 위한 HTTP 캐싱 전략	REST API 캐시 설계
2	HTTP 압축: gzip vs Brotli vs zstd	압축 알고리즘별 성능 비교
3	연결 관리와 Keep-Alive	TCP 연결 재사용 전략
4	TTFB(Time to First Byte) 최적화	첫 바이트 도달 시간 단축
5	API 로드 밸런싱 전략	로드 밸런싱 알고리즘 비교
6	WebSocket 성능 튜닝	웹소켓 대규모 연결 최적화
7	CDN 캐싱 전략	컨텐츠 전송 네트워크 엣지 캐싱
8	HTTP 클라이언트 연결 풀링	커넥션 풀 최적화
9	테일 레이턴시: P99가 중요한 이유	꼬리 지연 시간 관리
10	리소스 힌트: Preload, Prefetch	브라우저 리소스 사전 로딩
11	HTTP/2 서버 푸시	서버 주도 리소스 전송
12	API 응답 시간 최적화	DB부터 네트워크까지 전구간 최적화

3.8. Production Infrastructure (12편)

프로덕션 환경의 인프라 운영과 관련된 시리즈. 리버스 프록시, TLS, 로그 관리, 무중단 배포 등을 다룬다.

[전체 가이드 목록 (12편)]

||<tablewidth=100%> # || 가이드 || 주요 내용 ||

1	리버스 프록시 설정: Nginx, Caddy, HAProxy	Nginx, Caddy, HAProxy 비교·설정
2	TLS 종단: HTTPS를 어디서 끝낼 것인가	TLS 종단 위치 결정
3	무중단 배포: Blue-Green, Canary, Rolling	배포 전략별 장단점
4	커스텀 에러 페이지: 404, 500, 502	사용자 친화적 에러 페이지 설계
5	로드 밸런서 헬스 체크	HTTP, TCP, gRPC 프로브 설정
6	Request ID와 분산 추적	트레이싱 시스템 설계
7	상태 코드 관측 가능성	메트릭, 로그, 알림 설계
8	엣지 레벨 Rate Limiting	WAF, CDN, API 게이트웨이 전략
9	CDN 설정: 동적·정적 콘텐츠	CDN 설정 최적화
10	Connection Draining: 우아한 종료	요청 유실 없는 서버 재시작
11	HTTP 액세스 로그 관리	로그 로테이션, 파싱, 분석
12	시크릿 관리: API 키, 토큰, 인증서	민감 정보 안전한 관리

3.9. Email Delivery (10편)

이메일 전달률 개선과 SMTP 프로토콜 관련 시리즈. SPF, DKIM, DMARC 설정부터 대량 이메일 전송까지 다룬다.

[전체 가이드 목록 (10편)]

||<tablewidth=100%> # || 가이드 || 주요 내용 ||

1	SMTP 응답 코드 해설	이메일 서버가 보내는 메시지 해석
2	이메일 전달률 개선: SPF, DKIM, DMARC	SPF, DKIM, DMARC 인증 설정
3	이메일 반송 진단: Soft vs Hard 바운스	일시적(4xx) vs 영구적(5xx) 반송
4	SMTP 인증 방식 해설	PLAIN, LOGIN, CRAM-MD5 등
5	이메일 헤더 분석: 배달 경로 추적	Received 헤더로 경유 서버 추적
6	대량 이메일 발송: 스팸 폴더 회피	IP 평판, 발송 속도 관리
7	DMARC 리포트 분석	Aggregate·Forensic 리포트 해석
8	이메일 피드백 루프(FBL)	스팸 신고 처리
9	IP 워밍: 발신자 평판 구축	신규 IP 이메일 발송 전략
10	트랜잭셔널 이메일 베스트 프랙티스	영수증, 알림, 비밀번호 재설정

3.10. DNS & Networking (10편)

DNS와 네트워크 기초를 다루는 시리즈. DNSSEC, DNS 전파, TCP 3-way 핸드셰이크 등을 설명한다.

[전체 가이드 목록 (10편)]

||<tablewidth=100%> # || 가이드 || 주요 내용 ||

1	DNS 응답 코드(RCODE) 해설	NOERROR, SERVFAIL, NXDOMAIN 등
2	DNS TTL 설정 가이드	TTL 값 설정과 전파 지연
3	DNS 전파: 변경이 느린 이유	네임서버 변경 후 전파 과정
4	DNSSEC 구현 가이드	DNS 보안 확장 설정
5	DNS 기반 페일오버와 고가용성	DNS 레벨 장애 조치
6	FTP 응답 코드 해설	FTP 파일 전송 응답 해석
7	DNS 레코드 타입 해설	A, AAAA, CNAME, MX, TXT 등
8	DNS over HTTPS(DoH)와 DoT	암호화된 DNS 쿼리
9	TCP 3-Way 핸드셰이크	TCP 연결 수립 과정
10	네트워크 디버깅 도구	ping, traceroute, mtr, tcpdump

3.11. Real-Time Protocols (10편)

실시간 통신 프로토콜을 다루는 시리즈. 웹소켓, gRPC 스트리밍, SSE, SIP, WebRTC 등을 설명한다.

[전체 가이드 목록 (10편)]

||<tablewidth=100%> # || 가이드 || 주요 내용 ||

1	WebSocket 종료 코드 해설	연결 끊김 이유 진단
2	SIP 응답 코드 해설	VoIP 호 설정 상태 코드
3	Server-Sent Events(SSE) 구현	서버→클라이언트 단방향 스트리밍
4	gRPC 스트리밍 패턴	단방향, 양방향 스트리밍
5	SIP 호 설정 과정(Call Flow)	INVITE→200 OK→ACK 시퀀스
6	WebSocket 인증 패턴	연결 시 인증 처리 방식
7	WebSocket vs SSE: 선택 기준	양방향 vs 단방향 프로토콜 비교
8	WebRTC 시그널링: SIP와 WebSocket	WebRTC 연결 수립 과정
9	gRPC 스트리밍 vs REST 폴링	실시간 데이터 전달 비교
10	MQTT 프로토콜: IoT 메시징	경량 메시징 프로토콜

3.12. Protocol Deep Dives (10편)

주요 RFC 문서를 심층 분석하는 시리즈. 프로토콜 설계 철학과 핵심 개념을 원문 기반으로 해설한다.

[전체 가이드 목록 (10편)]

||<tablewidth=100%> # || 가이드 || 주요 내용 ||

1	RFC 9110: HTTP 시맨틱스 심층 분석	HTTP의 의미론적 기반
2	RFC 6455: WebSocket 프로토콜 분석	웹소켓 프레임 구조와 핸드셰이크
3	RFC 5321: SMTP 프로토콜 분석	SMTP 명령 시퀀스와 확장
4	RFC 7540: HTTP/2 분석	멀티플렉싱, HPACK, 스트림 우선순위
5	RFC 9114: HTTP/3 분석	QUIC 기반 HTTP/3 설계
6	RFC 3261: SIP 프로토콜 분석	SIP 다이얼로그와 트랜잭션
7	RFC 959: FTP 프로토콜 분석	FTP 명령 채널과 데이터 채널
8	RFC 7231/9110: HTTP 메서드 의미론	Safe, Idempotent, Cacheable 특성
9	TLS 1.3: 더 빠르고 더 안전하게	TLS 1.3 핸드셰이크 개선
10	QUIC 프로토콜: HTTP/3의 전송 계층	UDP 기반 QUIC 설계

3.13. API Gateway Patterns (10편)

API 게이트웨이의 다양한 패턴을 다루는 시리즈. 인증, 라우팅, 변환, 속도 제한 등 게이트웨이 레벨의 관심사를 설명한다.

[전체 가이드 목록 (10편)]

||<tablewidth=100%> # || 가이드 || 주요 내용 ||

1	API 게이트웨이 패턴 개론	아키텍처와 주요 사용 사례
2	게이트웨이 인증: JWT, OAuth, API Key	게이트웨이 레벨 인증 처리
3	게이트웨이 Rate Limiting 패턴	Token Bucket, Sliding Window, Quota
4	요청 라우팅: 경로, 헤더, 콘텐츠 기반	라우팅 규칙 설계
5	요청/응답 변환	헤더, 본문 변환 패턴
6	게이트웨이 서킷 브레이커	게이트웨이 레벨 장애 격리
7	게이트웨이 CORS 처리	중앙 집중식 CORS 관리
8	재시도와 타임아웃 정책	백엔드 호출 재시도 전략
9	게이트웨이 API 버저닝	URI, Header, Media Type 방식
10	게이트웨이 로깅과 분석	요청 추적과 분석

3.14. Migration & Upgrades (8편)

프로토콜 마이그레이션과 업그레이드를 다루는 시리즈. HTTP/2, gRPC, TLS 1.3 등으로의 전환 과정을 안내한다.

[전체 가이드 목록 (8편)]

||<tablewidth=100%> # || 가이드 || 주요 내용 ||

1	HTTP/1.1에서 HTTP/2 마이그레이션	HTTP/2 전환 체크리스트
2	REST에서 gRPC 마이그레이션	gRPC 전환 전략
3	HTTP/2에서 HTTP/3 마이그레이션	QUIC 배포 가이드
4	SOAP에서 REST 마이그레이션	레거시 SOAP API 현대화
5	TLS 1.2에서 1.3 마이그레이션	TLS 1.3 설정과 호환성
6	FTP에서 SFTP 마이그레이션	보안 파일 전송으로 전환
7	모놀리스에서 마이크로서비스 API 전환	점진적 분리 전략
8	WebSocket에서 SSE 마이그레이션	단방향 통신 전환

3.15. Testing & Mocking (10편)

API 테스트와 모킹에 관한 시리즈. 단위 테스트, 통합 테스트, 계약 테스트, 카오스 엔지니어링 등을 다룬다.

[전체 가이드 목록 (10편)]

||<tablewidth=100%> # || 가이드 || 주요 내용 ||

1	API 테스트 전략: 단위, 통합, 계약, E2E	테스트 피라미드 설계
2	모의 서버: WireMock, Prism	Mock 서버 활용
3	에러 시나리오 테스트	4xx, 5xx 응답 시뮬레이션
4	계약 테스트: Pact	Consumer-Driven 계약 테스트
5	부하 테스트: k6, Locust, Artillery	로드 테스트 도구 비교
6	카오스 엔지니어링	장애 주입과 복원력 검증
7	HTTP 녹화·재생: VCR, Polly, Nock	테스트 재현성 확보
8	API 스키마 유효성 검증	OpenAPI, JSON Schema 검증
9	API 보안 테스트	OWASP ZAP, Burp Suite 활용
10	API 성능 벤치마킹	기준선 수립과 추적

4. 상태 코드 비교

상태 코드 비교 섹션에서는 흔히 혼동되는 상태 코드 쌍을 나란히 비교한다. 41개의 선별된 비교 페이지와 프로토콜 간 자동 생성 비교 페이지를 제공한다.

4.1. HTTP 동일 프로토콜 비교 (14쌍)

같은 HTTP 프로토콜 내에서 혼동되는 코드 쌍을 비교한다. 예를 들어 401 vs 403은 인증과 인가의 차이를, 301 vs 302는 영구 리다이렉트와 임시 리다이렉트의 차이를 설명한다.

비교	핵심 차이
301 vs 302	영구 vs 임시 리다이렉트
301 vs 308	메서드 변경 가능 vs 메서드 보존
302 vs 307	구형 vs 신형 임시 리다이렉트
307 vs 308	임시 vs 영구 (메서드 보존)
401 vs 403	인증 필요 vs 권한 없음
400 vs 422	구문 오류 vs 의미 오류
404 vs 410	없음 vs 영구 삭제
500 vs 502	서버 에러 vs 게이트웨이 에러
500 vs 503	서버 에러 vs 일시적 과부하
502 vs 504	잘못된 응답 vs 응답 시간 초과
200 vs 201	성공 vs 리소스 생성
200 vs 204	본문 있음 vs 본문 없음
429 vs 503	속도 제한 vs 서비스 불가
301 vs 307	영구(메서드 변경 가능) vs 임시(메서드 보존)

4.2. 크로스 프로토콜 비교 (13쌍)

서로 다른 프로토콜 간에 유사한 의미를 가진 코드를 비교한다. HTTP에서 gRPC, DNS, WebSocket, SIP으로의 대응 관계를 설명한다.

[전체 비교 목록 (13쌍)]

||<tablewidth=100%> 비교 || 프로토콜 || 핵심 차이 ||

HTTP 404 vs gRPC NOT_FOUND	HTTP ↔ gRPC	리소스 없음의 프로토콜별 표현
HTTP 401 vs gRPC UNAUTHENTICATED	HTTP ↔ gRPC	인증 실패 표현
HTTP 403 vs gRPC PERMISSION_DENIED	HTTP ↔ gRPC	권한 부족 표현
HTTP 500 vs gRPC INTERNAL	HTTP ↔ gRPC	서버 에러 표현
HTTP 503 vs gRPC UNAVAILABLE	HTTP ↔ gRPC	서비스 불가 표현
HTTP 408 vs gRPC DEADLINE_EXCEEDED	HTTP ↔ gRPC	타임아웃 표현
HTTP 409 vs gRPC ALREADY_EXISTS	HTTP ↔ gRPC	충돌/중복 표현
HTTP 429 vs gRPC RESOURCE_EXHAUSTED	HTTP ↔ gRPC	속도 제한 표현
HTTP 404 vs DNS NXDOMAIN	HTTP ↔ DNS	"없음"의 계층별 차이
HTTP 500 vs WS 1011	HTTP ↔ WebSocket	서버 에러의 프로토콜별 차이
HTTP 401 vs SIP 401	HTTP ↔ SIP	같은 코드, 다른 인증 메커니즘
HTTP 200 vs SIP 200	HTTP ↔ SIP	같은 코드, 다른 의미 범위
HTTP 200 vs gRPC OK	HTTP ↔ gRPC	성공 응답의 프로토콜별 차이

4.3. SIP · SMTP · FTP · DNS 비교

[프로토콜별 비교 (14쌍)]

||<tablewidth=100%> 프로토콜 || 비교 || 핵심 차이 ||

SIP	401 vs 407	사용자 인증 vs 프록시 인증
SIP	480 vs 486	일시적 부재 vs 통화 중
SIP	486 vs 600	단말 통화 중 vs 전체 통화 중
SIP	404 vs 604	사용자 없음(로컬) vs 사용자 없음(글로벌)
SIP	488 vs 606	미디어 불일치 vs 완전 거부
SIP	607 vs 608	스팸 거부 vs 신원 거부
SMTP	450 vs 550	메일함 일시 불가 vs 영구 불가
SMTP	530 vs 535	인증 필요 vs 인증 실패
SMTP	421 vs 521	서비스 일시 중단 vs 수신 거부
FTP	450 vs 550	파일 일시 불가 vs 영구 불가
FTP	227 vs 229	Passive Mode(IPv4) vs Extended(IPv6)
FTP	421 vs 530	서비스 종료 vs 로그인 필요
DNS	SERVFAIL vs REFUSED	서버 장애 vs 쿼리 거부
DNS	NXDOMAIN vs NOERROR	도메인 없음 vs 정상(레코드 없음)

5. 에러 시나리오

에러 시나리오 섹션에서는 실무에서 자주 발생하는 70개의 에러 상황에 대해 증상 → 원인 → 해결 방법의 구조화된 플레이북을 제공한다. 각 시나리오는 해당 프로토콜의 상태 코드와 연계되어 있다.

프로토콜	시나리오 수	대표적 시나리오
HTTP	25개	Nginx 뒤 502 Bad Gateway, CORS 403 설정 오류, CSRF 토큰 불일치
SMTP	10개	550 메일함 없음, SPF/DKIM/DMARC 실패
gRPC	8개	UNAVAILABLE 연결 실패, DEADLINE_EXCEEDED 타임아웃
DNS	8개	NXDOMAIN 도메인 없음, SERVFAIL 서버 장애
FTP	7개	530 로그인 실패, 425 패시브 모드 방화벽
WebSocket	7개	1006 비정상 종료, 1015 TLS 핸드셰이크 실패
SIP	5개	401 등록 실패, 488 코덱 불일치

6. 사양 문서

사양 문서 섹션에서는 51개의 RFC와 표준 사양을 요약·해설한다. 각 사양 문서에 대해 핵심 내용, 관련 상태 코드, 실무적 의미를 설명한다.

분류	수량	주요 사양
HTTP & 웹	13개	RFC 9110 (HTTP 시맨틱스), RFC 9111 (HTTP 캐싱), RFC 9113 (HTTP/2), RFC 9114 (HTTP/3), RFC 9457 (Problem Details)
보안 & 인증	3개	RFC 6749 (OAuth 2.0), RFC 6750 (Bearer Token), RFC 7519 (JWT)
이메일	6개	RFC 5321 (SMTP), RFC 7208 (SPF), RFC 6376 (DKIM), RFC 7489 (DMARC)
DNS	8개	RFC 1035 (DNS), RFC 4033 (DNSSEC), RFC 8484 (DoH), RFC 7858 (DoT)
FTP	5개	RFC 959 (FTP), RFC 4217 (FTP over TLS)
SIP	5개	RFC 3261 (SIP), RFC 3265 (SIP Events)
WebSocket	3개	RFC 6455 (WebSocket), RFC 7692 (압축)
gRPC	3개	gRPC Status Codes, Protocol Buffers, gRPC Streaming

7. 의사결정 트리

의사결정 트리 섹션에서는 상황에 맞는 올바른 상태 코드나 프로토콜을 선택할 수 있도록 12개의 인터랙티브 의사결정 가이드를 제공한다. 질문에 답하면 적절한 코드를 추천받을 수 있다.

의사결정 트리	시작 질문
어떤 HTTP 에러 코드를 반환할 것인가?	요청에 문제가 있는가, 서버에 문제가 있는가?
어떤 HTTP 리다이렉트를 사용할 것인가?	이동이 영구적인가, 메서드를 보존해야 하는가?
어떤 HTTP 성공 코드를 반환할 것인가?	리소스를 생성했는가, 비동기 처리인가?
이 HTTP 응답을 캐시해야 하는가?	응답이 변하는가, 사용자별로 다른가?
401 vs 403: 어떤 코드를 반환할 것인가?	인증 정보가 없는가, 권한이 없는가?
어떤 gRPC 상태 코드를 반환할 것인가?	입력 유효성 문제인가, 서버 상태 문제인가?
DNS 해석이 실패하는 이유는?	도메인이 존재하는가, 네임서버가 응답하는가?
어떤 WebSocket 종료 코드를 사용할 것인가?	정상 종료인가, 에러 상황인가?
이메일이 반송되는 이유는?	일시적 문제인가, 영구적 문제인가?
어떤 이메일 인증을 설정할 것인가?	SPF, DKIM, DMARC 중 무엇이 필요한가?
프로토콜 간 에러를 어떻게 매핑할 것인가?	HTTP ↔ gRPC ↔ WebSocket 대응
어떤 프로토콜을 사용할 것인가?	실시간인가, 단방향인가, 양방향인가?

8. 용어사전

용어사전 섹션에서는 네트워크 프로토콜, 보안, API 설계 관련 360개 이상의 기술 용어를 18개 카테고리로 분류하여 정의한다.

카테고리	주요 용어
HTTP 개념	상태 코드, 콘텐츠 협상, 리다이렉트, 쿠키, HTTP/2, HTTP/3
API 설계	REST, GraphQL, 페이지네이션, API 버저닝, Webhook, OpenAPI
보안	CORS, XSS, CSRF, HSTS, CSP, SQL 인젝션
네트워킹	TCP/IP, 3-Way 핸드셰이크, NAT, 방화벽, IPv6
캐싱 & 성능	Cache-Control, ETag, CDN, stale-while-revalidate
에러 처리	Rate Limiting, 멱등성, 멱등성 키
DNS	DNS 해석, TTL, DNSSEC, DNS over HTTPS
이메일 & SMTP	SMTP 릴레이, SPF/DKIM/DMARC, 이메일 전달률
실시간 & 스트리밍	WebSocket 프레임, gRPC 스트리밍, WebRTC
인증 & OAuth	OAuth, JWT, Bearer Token, API Key
TLS & 암호화	TLS 핸드셰이크, 인증서, 암호 스위트, 상호 TLS
gRPC & RPC	Protocol Buffers, 직렬화
SIP & VoIP	SIP 다이얼로그, 시그널링
FTP & 파일 전송	액티브/패시브 모드, SFTP, 데이터 채널
로드 밸런싱 & 프록싱	로드 밸런서, 리버스 프록시, 커넥션 풀링
인프라	Keep-Alive, 소켓, MTU
웹 표준	RFC, IANA, 프로토콜 업그레이드
프로토콜 설계	요청-응답 모델, 멀티플렉싱, 하위 호환성

9. 개발자 도구

개발자 도구 섹션에서는 7개의 인터랙티브 도구를 제공한다. 모든 도구는 브라우저에서 바로 사용할 수 있다.

9.1. HTTP Header Checker

HTTP Header Checker는 임의의 URL에 대해 HTTP 응답 헤더와 상태 코드를 검사하는 도구이다. URL을 입력하면 응답 헤더 전체를 확인할 수 있으며, 보안 헤더(HSTS, CSP, X-Frame-Options 등)의 적용 여부, 캐시 관련 헤더(Cache-Control, ETag, Expires), 서버 정보 등을 한눈에 파악할 수 있다.

9.2. Status Code Tester

Status Code Tester는 숫자를 입력하면 7개 프로토콜에서 해당 숫자가 어떤 의미를 가지는지 한눈에 보여주는 도구이다. 예를 들어 "200"을 입력하면 HTTP 200 OK, SIP 200 OK 등 프로토콜별 의미를 동시에 확인할 수 있다. "404"를 입력하면 HTTP 404 Not Found뿐 아니라 SIP 404 Not Found의 의미도 비교할 수 있다.

9.3. Mock Response Generator

Mock Response Generator는 원하는 상태 코드와 헤더를 지정하여 가상의 HTTP 응답을 생성하는 도구이다. curl 명령어와 코드 스니펫을 자동으로 생성해주므로, API 개발 중 에러 응답 시나리오를 테스트할 때 유용하다.

9.4. API Response Mock

API Response Mock은 8개 주요 웹 프레임워크에서 특정 상태 코드를 반환하는 코드 스니펫을 제공한다. Django, Flask, FastAPI, Express.js, Spring Boot, Go, Ruby on Rails, ASP.NET Core 프레임워크를 지원하며, 복사-붙여넣기로 바로 사용할 수 있다.

모든 상태 코드에 대해 프레임워크별 모의 응답 코드를 확인할 수 있다.

9.5. Redirect Tracer

Redirect Tracer는 URL의 전체 리다이렉트 체인을 추적하는 도구이다. 301, 302, 303, 307, 308 등 각 홉(hop)의 상태 코드, 목적지 URL, 응답 시간을 시각화해준다. SEO 감사나 리다이렉트 루프 디버깅에 유용하다.

9.6. JWT Decoder

JWT Decoder는 JSON Web Token을 디코딩하여 헤더, 페이로드, 서명을 구문 강조와 함께 보여주는 도구이다. 모든 처리가 브라우저 내에서 이루어지며, 토큰 데이터가 서버로 전송되지 않으므로 보안이 중요한 상황에서도 안전하게 사용할 수 있다.

9.7. CORS Checker

CORS Checker는 임의의 URL에 대해 교차 출처 리소스 공유 헤더를 점검하는 도구이다. Access-Control-Allow-Origin, Allow-Methods, Allow-Headers, Allow-Credentials 등의 설정을 확인하고, 잠재적 보안 이슈를 진단해준다.

10. 다국어 지원

15개 언어를 지원한다. 인터페이스와 콘텐츠가 번역되어 있으며, URL 접두사 방식으로 언어를 전환한다.

언어	코드	URL 접두사
영어	en	(접두사 없음, 기본)
한국어	ko	/ko/
일본어	ja	/ja/
중국어 (간체)	zh-hans	/zh-hans/
스페인어	es	/es/
프랑스어	fr	/fr/
독일어	de	/de/
포르투갈어	pt	/pt/
러시아어	ru	/ru/
아랍어	ar	/ar/
힌디어	hi	/hi/
인도네시아어	id	/id/
태국어	th	/th/
터키어	tr	/tr/
베트남어	vi	/vi/

11. 유사 서비스와의 비교

항목	ProtocolCodes	MDN Web Docs	httpstatuses.io	HTTP.cat
프로토콜 범위	7개 (HTTP, SMTP, gRPC, DNS, WebSocket, FTP, SIP)	HTTP 중심 (일부 WebSocket)	HTTP만	HTTP만
상태 코드 수	300+	HTTP만 ~60개	HTTP ~60개	HTTP ~40개
코드 비교	41개 비교 페이지 + 크로스 프로토콜	없음	없음	없음
가이드	172편 (15개 시리즈)	별도 문서로 분산	없음	없음
에러 시나리오	70개 (증상→원인→해결)	제한적	없음	없음
의사결정 트리	12개 인터랙티브 가이드	없음	없음	없음
RFC 해설	51개	별도 MDN 참조	RFC 링크만	없음
개발자 도구	7개 (Header Checker, JWT Decoder 등)	없음	없음	없음
용어사전	360+ 용어 (18 카테고리)	일부 용어집	없음	없음
다국어	15개 언어	다수 언어	영어만	영어만
특징	프로토콜 통합 레퍼런스	웹 기술 종합 문서	간결한 참조	고양이 밈으로 설명

MDN Web Docs가 HTTP를 포함한 웹 기술 전반의 공식 문서 역할을 한다면, ProtocolCodes는 상태 코드라는 특정 주제에 집중하면서 HTTP 외의 프로토콜까지 범위를 넓힌 전문 레퍼런스이다.

1	Django	Django 상태 코드 처리
2	Express.js	Express.js 에러 미들웨어 가이드
3	FastAPI	FastAPI 응답 모델과 상태 코드
4	Spring Boot	Spring Boot @ControllerAdvice 에러 처리
5	Go	Go HTTP 에러 처리 패턴
6	gRPC	gRPC 에러 처리 베스트 프랙티스
7	Ruby on Rails	Rails 에러 처리 쿡북
8	ASP.NET Core	ASP.NET Core 에러 처리 가이드
9	Flask	Flask 에러 처리: 커스텀 페이지와 API
10	Laravel	Laravel 예외 처리
11	Next.js	Next.js API Routes 에러 처리
12	Rust (Actix-web)	Rust Actix-web 에러 처리