api설계
-
REST API 설계 원칙 중 PUT, PATCH 차이 (멱등성 관련)Web 2025. 4. 15. 15:29
💡 멱등성(Idempotence)이란?멱등성은 수학과 컴퓨터 과학에서 사용하는 개념으로, 같은 연산을 여러 번 적용해도 결과가 처음 한 번 적용했을 때와 동일한 성질을 말합니다.REST API에서 멱등성은 다음처럼 이해할 수 있어요:"같은 요청을 여러 번 보내더라도 서버 상태가 한 번 요청했을 때와 같아야 한다."🔍 예시로 이해하기 DELETE /users/123 요청을 생각해봅시다. 한 번 보내면 사용자 123이 삭제됩니다. 두 번 보내도 이미 삭제되어 있어서 서버 상태엔 변화가 없습니다.→ 따라서 DELETE는 멱등한 메서드입니다.✅ HTTP Method와 멱등성 HTTP Method 멱등성 있음? 설명 GET ✅ ..
-
🌐 RESTful API 설계 원칙 정리하기!Web 2025. 4. 15. 15:17
RESTful API는 웹 서비스를 설계할 때 가장 널리 사용되는 아키텍처 스타일 중 하나입니다. "REST"는 Representational State Transfer의 약자로, 자원을 명확하고 일관된 방식으로 접근할 수 있도록 해주는 규칙을 말해요. 이번 포스트에서는 RESTful API를 설계할 때 지켜야 할 핵심 원칙들을 정리해볼게요. ✅ 1. 자원(Resource)은 명사로, URI는 단수 or 복수형 REST에서는 URI가 자원을 나타내야 해요. 즉, 무엇을 조작할지를 나타내는 거죠. 예시: ❌ GET /getUser ✅ GET /users/1 자원의 집합은 보통 복수형으로 표현해요. 동작 HTTP 요청 설명..