테크커런트

📡 “404야, 내 마음도 Not Found다...”

✅ HTTP 상태코드란?

서버가 클라이언트의 요청에 대해 어떤 결과를 돌려줬는지 알려주는 숫자 코드입니다.

예를 들어...

• "응, 잘 받았어!" → 200 OK
• "어..? 너 누구?" → 401 Unauthorized
• "뭐라는 거야?" → 400 Bad Request

🎯 상태코드는 크게 5가지로 나뉩니다

🔵 2xx: 성공했어요!

🟡 3xx: 어이쿠! 이리로 와요~

🔴 4xx: 너가 잘못했어 (Client Error)

⚫ 5xx: 서버가 잘못했어요 (Server Error)

😂 코드별 상황극 예시

[404 Not Found]
👉 너 걔 봤어?
👤 누구?
👉 내 미래.

[403 Forbidden]
👉 사장님, 이 폴더 좀 볼게요.
👤 ...너 권한 없어. 꺼져.

🔐 상태코드, 실무에선 이렇게 써요!

• API 응답에 반드시 상태코드 명확히 반환
• 정상 처리: 200 또는 201
• 예외 처리: 400, 401, 403, 500 등 구분
• 프론트와 협업 시 명확한 상태 정의 문서 공유 필요

RESTful API는 웹 개발자라면 반드시 알아야 할 핵심 기술입니다.

✅ REST란 무엇인가요?

**REST(Representational State Transfer)**는 2000년에 로이 필딩(Roy Fielding)이 논문에서 처음 제안한 아키텍처 스타일입니다.
쉽게 말해, 웹에서 자원을 HTTP 방식으로 다루는 표준화된 방법이라고 생각하시면 됩니다.

📌 REST의 6가지 핵심 제약조건

🧭 RESTful API란?

REST 원칙을 따르는 API를 말합니다. 즉, HTTP 메서드와 URL을 이용해 자원을 CRUD 방식으로 처리하는 것이죠.

🚀 RESTful API 예제

가상의 블로그 게시글(Post)에 대한 API를 설계한다고 가정해볼게요.

🔄 RESTful 하지 않은 API 예시

GET /getPosts
POST /createPost

• ❌ 이런 방식은 RESTful하지 않습니다.
• ✅ RESTful 방식은 명사 중심 URI와 HTTP 메서드를 적절히 사용하는 것이 핵심입니다.

💡 RESTful API 설계 시 팁

• URI에는 동사 대신 명사 사용
• URI는 소문자 사용
• 언더스코어(_)보단 하이픈(-) 사용 권장
• 응답 상태 코드 (200, 201, 400, 404 등) 정확히 설정
• 예외 응답은 JSON 형태로 일관되게 처리

🛠️ RESTful API 구현 프레임워크

• Spring Boot (Java)
• Express (Node.js)
• Flask / Django REST Framework (Python)
• FastAPI (Python, 최신 트렌드)
• Laravel (PHP)