[CS] #2. 네트워크 - (URL / URI), REST API

💡 네트워크
	URL
	URI
	REST API

[ URL ]

유일 자원 주소

:= 서버컴퓨터에서 클라이언트가 요청한 파일의 디렉토리를 나타낸다.

👉 주소창에 www.naver.com을 쳤을 때 생기는일

[ URI ]

:= 자원의 고유 식별자

=> URL은 위치를 가르키고, URI는 식별한다.

[ REST API ]

:= 서버에 리퀘스트할 때 자원의 id와 자원에 대한 처리(HTTP METHOD)를 포함하여 리퀘스트 되도록 하는 것

무상태(stateless) 환경에서 동작을 전제로 한다.보안 및 인증에 대해서는 JWT, OAuth와 같은 토큰 인증이 사용된다.

보다 RESTFUL하게 👇

< HTTP Methods >

1. GET

자원을 받아오기만 할때 사용한다.

2. POST

새로운 자원을 추가할 때 사용한다.

3. PUT

존재하는 자원을 변경 할 때 사용한다.

POST는 여러개의 자원에 수행되는 반면, PUT은 단일 자원에만 수행된다.

4. DELETE

자원을 삭제할 때 사용한다.

이미 제거되었으므로404(NOT FOUND)를 반환받는다.

5. PATCH

한 자원의 데이터를 부분적으로 변경할 때 사용한다.

PUT도 마찬가지로 자원을 변경할 수 있다. 하지만 존재하는 자원에 대해 부분적으로 업데이트를 위해서는 PATCH를 사용한다.

< REST API 이점 >

확장성

REST API를 구현하는 시스템은 REST가 클라이언트-서버 상호 작용을 최적화하기 때문에 효율적으로 크기 조정할 수 있습니다. 무상태는 서버가 과거 클라이언트 요청 정보를 유지할 필요가 없기 때문에 서버 로드를 제거합니다. 잘 관리된 캐싱은 일부 클라이언트-서버 상호 작용을 부분적으로 또는 완전히 제거합니다. 이러한 모든 기능은 성능을 저하시키는 통신 병목 현상을 일으키지 않으면서 확장성을 지원합니다.

유연성

RESTful 웹 서비스는 완전한 클라이언트-서버 분리를 지원합니다. 각 부분이 독립적으로 발전할 수 있도록 다양한 서버 구성 요소를 단순화하고 분리합니다. 서버 애플리케이션의 플랫폼 또는 기술 변경은 클라이언트 애플리케이션에 영향을 주지 않습니다. 애플리케이션 함수를 계층화하는 기능은 유연성을 더욱 향상시킵니다. 예를 들어, 개발자는 애플리케이션 로직을 다시 작성하지 않고도 데이터베이스 계층을 변경할 수 있습니다.

독립성

REST API는 사용되는 기술과 독립적입니다. API 설계에 영향을 주지 않고 다양한 프로그래밍 언어로 클라이언트 및 서버 애플리케이션을 모두 작성할 수 있습니다. 또한 통신에 영향을 주지 않고 양쪽의 기본 기술을 변경할 수 있습니다.

< REST API URI 7가지 규칙 >

1. URI의 마지막이 '/'로 끝나지 않아야 합니다.

better

http://www.itivllage.tistory.com/coffees (ㅇ)

worse

http://www.itivllage.tistory.com/coffees/ (x)

2. 동사 보다는 명사를 사용합니다.

better

http://www.itivllage.tistory.com/coffees (ㅇ)

worse

http://www.itivllage.tistory.com/coffees/update (x)

3. 단수형 보다는 복수형 명사를 사용합니다.

better

http://www.itivllage.tistory.com/coffees (ㅇ)

worse

http://www.itivllage.tistory.com/coffee (x)

4. URI는 기본 소문자로 사용합니다.

5. 언더스코어( _ ) 대신에 하이픈(-)을 사용합니다.

6. 파일 확장자는 URI에 포함하지 않습니다.

7. 계층관계를 나타낼 때는 슬래시 구분자를 사용해야한다.

참고할만한 REST API URI 컨벤션 👉 REST Resource Naming Guide

Comment