[HTTP] 5. HTTP 메서드 활용

Yeonsu Summer·2023년 3월 31일

개념정리

네트워크

목록 보기

5/8

HTTP 메서드 활용

Index

클라이언트에서 서버로 데이터 전송

HTTP API 설계 예시

1. 클라이언트에서 서버로 데이터 전송

1-1. 데이터 전달 방식

쿼리 파라미터

쿼리 파라미터를 통해 데이터를 전송할 때 주로 GET 메서드를 사용하고 정렬 필터(검색어) 기능에 사용한다.

메시지 바디

메시지 바디를 통해 데이터를 전송할 때 POST, PUT, PATCH 메서드를 사용하고 회원가입, 상품 주문, 리소스 등록, 리소스 변경과 같은 기능에 사용한다.

1-2. 4가지 상황

정적 데이터 조회

이미지나 정적 텍스트 문서를 조회하는 것을 정적 데이터라고 하고 GET 메서드를 사용한다. 일반적으로 쿼리 파라미터 없이 리소스 경로로 단순하게 조회할 수 있다.

동적 데이터 조회

검색이나 게시판 목록에서 정렬 필터(검색어)를 동적 데이터라고 한다. 조회 조건을 줄여주는 필터나 조회 결과를 정렬하는 정렬 조건에 주로 사용한다. 동적 데이터 또한 GET 메서드를 사용하며, 쿼리 파라미터를 사용하여 데이터를 전달한다.

HTML Form 데이터 전송

회원가입이나 상품 주문, 데이터 변경을 할 때 HTML Form 데이터를 사용한다.

HTML Form을 submit할 때 POST 메서드를 사용한다. Content-Type은 application/x-www-form-urlencoded를 사용하며 form의 내용을 메시지 바디를 통해 전송한다. 메시지 바디의 내용은 key=value 의 쿼리 파라미터 형식이다. 전송 데이터를 인코딩하기 때문에 'abc김'이라는 데이터가 'abc%EA%B9%80'이라는 데이터로 바뀐다.

파일 업로드 같은 바이너리 데이터를 전송할 때는 다른 multipart/form-data 라는 Content-Type 을 사용한다. 다른 종류의 여러 파일과 폼의 내용을 함께 전송할 수 있다.

HTML Form은 POST 뿐만 아니라 GET 메서드를 사용할 수도 있다. 대신 리소스 변경이 발생하는 곳에서 사용할 수 없고 조회만 가능하다. 따라서 전송 데이터는 메시지 바디가 아닌 URL 경로에 들어간다.

1-3. HTTP API 데이터 전송

HTTP API 데이터는 서버와 서버 사이에서 백엔드 시스템 통신을 하는 것이다. 클라이언트는 앱과 웹으로 나눌 수 있는데, 앱 클라이언트에는 아이폰과 안드로이드가 있다. 웹 클라이언트는 HTML에서 Form을 전송하는 대신 자바스크립트를 이용한 통신(AJAX)을 한다.

POST, PUT, PATCH 메서드는 메시지 바디를 통해 데이터를 전송하고, GET 메서드는 조회하거나 쿼리 파라미터로 데이터를 전달한다.

Content-Type은 application/json 을 주로 사용하고 이외에도 TEXT, XML 등이 있다.

2. HTTP API 설계 예시

2-1. POST 기반 등록

다음과 같이 POST 메서드를 기반으로 데이터를 등록할 수 있다.

요청 내용	경로	메서드
회원 목록	/members	GET
회원 등록	/members	POST
회원 조회	/members/{id}	GET
회원 수정	/members/{id}	PATCH, PUT, POST
회원 삭제	/members/{id}	DELETE

이 때 클라이언트는 등록될 리소스의 URI를 모른다. 대신 서버가 새로 등록된 리소스 URI를 생성해 클라이언트에게 Location: /memebrs/100 과 같이 경로를 알려준다.

/members 와 같이 경로의 맨 앞에 오는 것을 컬렉션이라고 한다. 컬렉션은 서버가 관리하는 리소스 디렉토리로, 서버가 리소스의 URI를 생성하고 관리한다.

2-2. PUT 기반 등록

다음과 같이 PUT 메서드를 기반으로 데이터를 등록할 수 있다.

요청 내용	경로	메서드
파일 목록	/files	GET
파일 등록	/files/{filename}	PUT
파일 조회	/files/{filename}	GET
파일 수정	/files/{filename}	DELETE
파일 삭제	/files	POST

이 때 클라이언트가 리소스 URI를 이미 알고 있어야 등록할 수 있고, 직접 리소스의 URI를 지정한다. URI는 files/star.jpg 와 같은 형식이다.

/files 와 같이 경로의 맨 앞에 오는 것을 스토어라고 한다. 스토어는 클라이언트가 관리하는 리소스 저장소로, 클라이언트가 리소스의 URI를 알고 관리한다.

참고로, 현업에서는 POST 메서드 기반을 주고 사용한다.

2-3. HTML Form 사용

HTML Form은 GET, POST 메서드만 지원하여 제약이 있다.

요청 내용	경로	메서드
회원 목록	/members	GET
회원 등록 폼	/members/new	GET
회원 등록	/members/new	POST
회원 조회	/members/{id}	GET
회원 수정 폼	/members/{id}/edit	GET
회원 수정	/members/{id}/edit	POST
회원 삭제	/members/{id}/delete	POST