7/10 HTTP 웹 기본 지식 - HTTP API 설계 예시
HTTP API 설계 예시
• HTTP API - 컬렉션
• POST 기반 등록
• 예) 회원 관리 API 제공
• HTTP API - 스토어
• PUT 기반 등록
• 예) 정적 컨텐츠 관리, 원격 파일 관리
• HTML FORM 사용
• 웹 페이지 회원 관리
• GET, POST만 지원
POST로 신규 데이터 등록 : 클라이언트는 서버에 요청
서버가 리소스 URI를 알아서 내려줌
PUT 기반 등록 : 리소스 URI를 다 알고 등록->
클라이언트가 등록될 리소스의 URI를 본인이 직접 다 관리. 서버는 그냥 온대로 해줌
=> 이런 스타일의 관리를 스토어 라고 함.
대부분 POST기반 컬렉션을 사용
HTML FORM 사용
• HTML FORM은 GET, POST만 지원
• AJAX 같은 기술을 사용해서 해결 가능 -> 회원 API 참고
• 여기서는 순수 HTML, HTML FORM 이야기
• GET, POST만 지원하므로 제약이 있음
폼을 보는것 -> GET
버튼을 눌러야 폼 데이터가 서버로 넘어감 -> POST
회원 등록 폼 /members/new -> GET
회원 등록 /members/new -> POST 로 맞춰주는게 경로가 안바뀌어서 깔끔.
DELETE 못쓰므로 /delete라는 컨트롤 URL를 써야함
최대한 리소스라는 개념을 가지고 URI를 설계하고, 그 상황에서 안될때 컨트롤 URI를 대체제로 쓴다
기준
1.미네랄만 가지고 리소스를 설계
회원 : 컬렉션이기 때문에 members
주문 : orders
상세는 /번호
2.이걸로 해결 안되면 컨트롤 URI