HTTP API기본

API URI를 설계하는 것은 HTTP통신에서 빠질 수 없는 설계다.

 

어떻게 설계해야 하는지 알아보자!!!!!

 

우선

- 회원 목록 조회

- 회원 조회

- 회원 등록

- 회원 수정

- 회원 삭제

 

위의 목록의 URI를 설계해야 한다고 생각해 보자!

- 회원 조회 /read-member-list

- 회원 등록 / create-member-list

- 회원 수정 / update-member

- 회원 삭제 / delete-member

이렇게 만들수 있을 것이다. 

과연 위의 리스트가 잘 만든 uri일까???

 

uri에서 가장 중요한 점은 리소스를 식별하는 것이다.

 

리소스란

- 회원을 등록하고 수정하고 삭제하고 조회하는 것이 아니다!!

- 회원이라는 개념 그자체이다.

 

리소스를 식별하는 방법은

- 회원을 등록하고 수정하고 조회하는 것을 모두 배제하고

- 회원이라는 리소스만 식별하면 된다 -> 회원 리소스를 uri에 매핑

 

- 회원 목록 조회 / members
- 회원 조회 / members/{id}
- 회원 등록 / members/{id}
- 회원 수정 / members/{id}
- 회원 삭제 / members/{id} 

결국 위의 리스트같은 uri를 만들면 된다.

 

하지만 여기서 생각해야 할 것이 있다.

목록 조회는 쉽게 구분이 가지만 조회, 등록, 수정,삭제 같은 경우에는 어떻게 구분해야하는 것일까?

 

정답을 찾기 전에 정리를 다시 한번 한다면

uri에서 가장 중요한 것은 리소스와 행위를 분리하는 것이다.

즉 uri는 해당 리소스를 대상으로 행위를 분리한다

- 리소스 : 회원 -> 명사

- 행위 : 조회,등록,삭제,변경 -> 동사

 

따라서 위의 리스트들을 봤을 때 회원이라는 명사는 정해졌고

조회하다, 등록하다, 수정하다, 삭제하다와 같은 동사들을 구분할 방법이 필요하다.

 

이런 방법은 다음 더 디테일하게 공부할 GET,POST,PUT,PATCH,DELETE의 HTTP 메서드를 통해 구분할 수 있다.