That's IT

REST(Representational State Transfer)는 웹 애플리케이션의 아키텍처 스타일로, 클라이언트와 서버 간의 상호작용을 쉽게 하고, 효율적으로 데이터를 주고받을 수 있도록 설계된 방식입니다. Restful API는 이런 아키텍처 스타일을 따르는 API를 의미하며, HTTP 프로토콜을 기반으로 클라이언트와 서버 간의 통신을 정의합니다. Restful  API는 주로 HTTP 메소드를 사용하여 다양한 동작을 수행하며, 각각의 메소드는 클라이언트가 서버에게 요청하는 작업의 종류를 나타냅니다.

이 글에서는 HTTP 메소드와 Restful API의 관계, 그리고 실무에서 HTTP 메소드를 꼭 따라야 하는지에 대한 고찰을 다루겠습니다.

2. Restful API 설계 시 HTTP 메소드 사용의 중요성

2.1 Restful 아키텍처에서의 HTTP 메소드

Restful API는 리소스 중심의 아키텍처 스타일입니다. 각 리소스는 고유한 URL로 식별되며, HTTP 메소드(GET, POST, PUT, DELETE, PATCH 등)를 사용하여 리소스에 대한 다양한 동작을 수행할 수 있습니다.

Restful 설계에서의 주요 규칙 중 하나는 하나의 URL이 특정 리소스를 가리키며, HTTP 메소드로 해당 리소스에 대해 어떤 동작을 할지 명확히 구분한다는 것입니다. 예를 들어, 사용자 리소스에 대한 다양한 작업을 HTTP 메소드로 구분할 수 있습니다:

• POST /users: 새로운 사용자 생성
• GET /users/1: 특정 사용자 정보 조회
• PUT /users/1: 특정 사용자 정보 전체 업데이트
• PATCH /users/1: 특정 사용자 정보 일부 업데이트
• DELETE /users/1: 특정 사용자 삭제

이렇게 함으로써 가독성과 유지 보수성이 높아지며, 요청의 의도가 명확해집니다.

2.2 HTML Form에서의 HTTP 메소드 제한

실제로 웹 개발에서는 HTML 폼에서 사용할 수 있는 HTTP 메소드가 제한적입니다. GET과 POST만을 지원하며, 이는 브라우저 보안과 호환성 때문입니다. 브라우저에서 PUT이나 DELETE와 같은 메소드는 보안상 위험을 일으킬 수 있기 때문에, 표준 HTML 폼에서는 이러한 메소드를 직접 지원하지 않습니다. 따라서 대부분의 브라우저 기반 요청은 GET과 POST에 의존할 수밖에 없습니다.

2.3 HTTP 메소드를 꼭 따라야 할까?

RESTful API 설계 원칙을 엄격히 따르는 것이 권장되지만, 현실적인 제약으로 인해 모든 API가 이 규칙을 준수하지는 않습니다. 많은 개발자들이 단순하게 POST 메소드만 사용하여 CRUD 작업을 수행하거나, GET을 남용하는 경우도 있습니다.

그러나 이러한 방식은 가독성과 유지 보수성을 떨어뜨리며, 장기적으로 API의 확장성과 협업에서 어려움을 초래할 수 있습니다. 각 HTTP 메소드는 그에 맞는 표준적인 용도가 있으며, 이를 적절히 사용함으로써 API의 명확성과 일관성을 유지할 수 있습니다.

3. 실무에서의 RESTful API와 HTTP 메소드 사용

3.1 실무에서의 HTTP 메소드 선택

실무에서는 팀의 개발 표준이나 보안상의 이유로 특정 HTTP 메소드를 제한적으로 사용할 수 있습니다. 예를 들어, POST 메소드 하나로 모든 작업을 처리하는 경우도 있습니다. 이는 보안 정책이나 기술적 이유로 이루어지기도 하며, 특히 POST는 가장 범용적으로 사용되는 메소드 중 하나입니다.

다만, 이러한 방식은 비표준적이며 가독성과 유지보수에 문제가 생길 수 있습니다. RESTful API의 장점인 명확한 의도를 살리기 위해, 가능하면 각 HTTP 메소드를 적절히 사용하는 것이 좋습니다.

3.2 보안 고려 사항

HTTP 메소드를 잘못 사용하면 보안 취약점이 발생할 수 있습니다. 특히, GET 요청에 중요한 데이터를 포함하는 것은 URL에 노출되기 때문에 위험할 수 있습니다. 따라서 보안상 중요한 작업(로그인, 데이터 전송 등)은 POST 메소드를 통해 처리하는 것이 일반적입니다.

4. 결론

RESTful API는 웹 개발에서 가독성, 유지 보수성, 일관성을 유지하기 위해 HTTP 메소드를 적절히 사용하는 것이 매우 중요합니다. 표준적인 HTTP 메소드(GET, POST, PUT, DELETE, PATCH 등)를 올바르게 사용함으로써, API의 동작을 명확하게 정의하고 협업과 유지보수를 용이하게 할 수 있습니다.

하지만 실무에서는 보안, 호환성, 팀의 개발 정책에 따라 HTTP 메소드 사용이 유연하게 바뀔 수 있으며, 이는 각 프로젝트의 상황에 따라 달라질 수 있습니다. 중요한 것은 이러한 규칙을 알고 상황에 맞게 적용하는 능력입니다.