클라이언트에서 서버로 데이터 전송 방식
- 쿼리 파라미터를 통한 데이터 전송(GET) - 쿼리 파라미터
- 메시지 바디를 통한 데이터 전송(POST, PUT, PATCH) - HTML Form, HTTP API
클라이언트에서 서버로 데이터를 전송하는 4가지 상황
- 정적 데이터 조회
- 이미지, 정적 텍스트 문서를 쿼리 파라미터 없이 리소스 경로로 단순하게 조회
- GET /static/star.jpg
- 동적 데이터 조회(쿼리 파라미터)
- 조회 조건을 줄여주는 필터, 조회 결과를 정렬하는 정렬 조건(검색어)에 주로 사용
- 쿼리 파라미터를 사용해서 데이터를 전달하여 조회
- GET /search?q=hello&hl=ko
- HTML Form 데이터 전송
- HTML Form 전송은 GET, POST만 지원
- POST
- 메시지 바디를 통한 데이터 전송
- Content-Type : application/x-www-form-unlencoded (default)
- form의 내용을 메시지 바디를 통해서 전송(key=value, 쿼리 파라미터 형식)
- Message Body: username=kim&age=20
- 전송 데이터를 url encoding 처리
- Content-Type : multipart/form-data
- Form 요소가 파일 업로드, 이미지 같은 바이너리 데이터를 전송 시 사용
- 다른 종류의 여러 파일과 폼의 내용을 함께 전송 가능
- GET
- 쿼리 파라미터를 통한 데이터 전송
- /members?username=kim&age=20
- HTTP API 데이터 전송
- 서버에서 서버로
- 앱 클라이언트
- 웹 클라이언트
- HTML에서 Form 전송 대신 자바 스크립트를 통한 통신에 사용(AJAX)
- 예) React, VueJs 같은 웹 클라이언트와 API 통신
- POST, PUT, PATCH : 메시지 바디를 통해 데이터 전송
- GET : 조회, 쿼리 파라미터로 데이터 전달
- Content-Type : application/json
- 주로 사용 (사실상 표준)
- TEXT, XML, JSON 등등
HTTP API 설계(신규 자원을 등록하는 방법, POST와 PUT)
POST의 신규 자원 등록 특징
- 서버가 새로 등록된 리소스 URI를 생성하고 관리
- POST /members
- 컬렉션(Collection)
- 서버가 관리하는 리소스 디렉토리
- 여기서 컬렉션은 /members
PUT의 신규 자원 등록 특징
- 클라이언트가 리소스의 URI를 알고 관리
- PUT /members/100
- 스토어(Store)
- 클라이언트가 관리하는 리소스 저장소
- 여기서 스토어는 /members