Web Develop - (1) 웹 개발이란?

Hyeri Park·2022년 7월 11일

API web

WEB

목록 보기

1/2

Web 이란?

World Wide Web, WWW, W3 인터넷에 연결된 컴퓨터를 통해 사람들이 정보를 공유할 수 있는 전 세계적인 정보 공간

Web의 용도

Web Site
(google, naver, daum, facebook) 등 HTML로 구성된 여러 사이트 들
API (Application Programming Interface) * Web Service
(Kakao Open API, Google Open API, Naver Open API 등)
User Interface
(Chrome, Safari, SmartWatch, IP TV 등)

REST 란?

Reprosentational State Transfer : 자원의 상태전달

자원의 식별

웹 기반의 REST에서는 리소스 접근을 할때 URI를 사용한다.

http://foo.co.kr/user/100
Resource : user
식별자 : 100

메시지를 통한 리소스 조작

Web의 데이터 전달방식 : HTML, XML, JSON, TEXT 등
이 중에 어떠한 타입의 데이터 인지 알려주기 위해 HTTP Header 부분에 content-type을 통해 데이터의 타입을 지정해 줄 수 있다.
리소스 조작을 위해 데이터 전체를 전달하지 않고 메시지로 전달한다.

자기서술적 메시지

요청하는 데이터가 어떻게 처리되어져야 하는지 충분한 데이터를 포함해야 한다.
HTTP 기반의 REST에서는 HTTP Method 와 Header정보, URI의 포함되는 정보로 표현할 수 있다.
그 외 담지 못한 정보들은 URI메시지를 통해 표현한다.

* GET : http://foo.co.kr/user/100, 사용자의 정보요청 
* POST : http://foo.co.kr/user  , 사용자의 정보생성 
* PUT : http://foo.co.kr/user   , 사용자의 정보생성 및 수정  
* DELETE : http://foo.co.kr/user/100, 사용자의 정보삭제

애플리케이션 상태에 대한 엔진으로써 하이퍼미디어

REST API를 개발할 때 단순히 Client 요청에 대한 데이터만 응답해주는 것이 아닌 관련된 리소스에 대한 Link 정보까지 같이 포함되어져야 한다.
이러한 조건을 잘 갖춘 경우 REST 하다고 표현하고 이를 REST API 라고 한다.

URI 란? (Uniform Resource Identifier)

인터넷에서 특정 자원을 나타내는 주소값, 해당 값은 유일하다 (응답은 달라질 수 있다)

요청 : https:// www.foo.co.kr/resource/sample/1
응답 : hyerihello.pdf, hyerihello.doc

URI 설계 원칙 (RFC-3986)

1) 슬래시 구분자 (/)는 계층 관계를 나타내는데 사용한다.
2) URI 마지막 문자로 (/)는 포함하지 않는다.
3) 하이픈(-)은 URI 가독성을 높이는데 사용한다.
4) 밑줄(_) 은 사용하지 않는다.
5) URI 경로에는 소문자가 적합하다.
6) 파일 확장자는 URI 에 포함하지 않는다.
7) 프로그래밍 언어에 의존적인 확장자를 사용하지 않는다.
8) 구현에 의존적인 경로를 사용하지 않는다.
9) 세션 ID를 포함하지 않는다.
10) 프로그래밍 언어의 Method명을 이용하지 않는다.
11) 명사에 단수형보다는 복수형을 사용해야한다. 컬렉션에 대한 표현을 복수로 사용
12) 컨트롤러 이름으로는 동사나 동사구를 사용한다.
13) 경로 부분중 변하는 부분은 유일한 값으로 대체한다.
14) CRUD 기능을 나타내는 것은 URI에 사용하지 않는다.
15) URI Query Parameter 디자인 ,
URI 쿼리 부분으로 컬렉션 결과에 대해서 필터링 할 수 있다.
16) API에 있어서 서브 도메인은 일관성 있게 사용해야한다.
17) 클라이언트 개발자 포탈 서브 도메인은 일관성 있게 만든다.