📍Restful API

✔️RESTful 이란

HTTP와 URI 기반으로 자원에 접근할 수 있도록 제공하는 애플리케이션 개발 인터페이스이다.

기본적으로 개발자는 HTTP 메소드와 URI 만으로 인터넷에 자료를 CRUD 할 수 있다.

'REST API'를 제공하는 웹 서비스를 'RESTful' 하다고 할 수 있다.

RESTful은 REST를 REST 답게 쓰기 위한 방법으로, 누군가가 공식적으로 발표한 것은 아니다.

---

📍RESTful API 개발 원칙

1. 자원을 식별할 수 있어야 한다.

• URL만으로 내가 어떤 자원을 제어하려고 하는지 알 수 있어야한다.(자원의 종류까지!)
• Server가 제공하는 정보는 JSON이나 XML형태로 HTTP body에 포함되어 전송시킨다.

2. 행위는 명시적이어야 한다.

• REST는 아키텍쳐 혹은 방법론과 비슷하다. 따라서 이런 방식을 사용해야 한다고 강제적이지 않다. 기존의 웹 서비스처럼, GET을 이용해서 UPDATE와 DELETE를 해도 된다.
• 다만 REST 아키텍쳐에는 부합하지 않으므로 REST를 따른다고 할 수는 없다.(RESTful하지 않다.)

3. 자기서술적이어야 한다.

• 데이터에 대한 메타정보만 가지고도 어떤 종류의 데이터인지, 데이터를 위해서 어떤 어플리케이션을 실행해야 하는지를 알 수 있어야한다.
• 즉, 데이터 처리를 위한 정보를 얻기 위해서, 데이터 원본을 읽어야 한다면 자기 서술적이지 못하다.

4. HATEOS(Hypermedia as the Engine of Application State)

• 클라이언트 요청에 대해 응답을 할 때, 추가적인 정보를 제공하는 링크를 포함할 수 있어야 한다.
• REST는 독립적으로 컴포넌트들을 손쉽게 연결하기 위한 목적으로도 사용된다. 따라서 서로 다른 컴포넌트들을 유연하게 연결하기 위해선, 느슨한 연걸을 만들어줄 것이 필요하다.(링크사용)
• 클라이언트는 하이퍼링크를 통해서 전체 네트워크와 연결되며 HATEOAS는 서버가 독립적으로 진화할 수 있도록 서버와 서버, 서버와 클라이언트를 분리할 수 있게 한다.

---

📍Representational State Transfer

• 자원(resource)을 이름(자원의 표현: representation)으로 구분하여 해당 자원의 상태(정보)를 주고 받는 모든 것

• 월드 와이드 웹(www)과 같은 분산 하이퍼미디어 시스템을 위한 소프트웨어 개발 아키텍처의 한 형식이다.

• REST는 기본적으로 웹의 기존 기술과 HTTP 프로토콜을 그대로 활용하기 때문에 웹의 장점을 최대한 활용할 수 있는 소프트웨어 프로그램 아키텍처 스타일이다.

---

📍REST의 구체적인 개념

HTTP URI를 통해 자원을 명시하고,

HTTP Method (POST, GET, PUT, DELETE)를 통해 해당 자원에 대한 CRUD OPERATION을 적용하는 것을 의미한다.

즉, REST는 자원 기반의 구조 (ROA: Resource Oriented Architecture) 설계의 중심에 Resoure가 있고 HTTP Method를 통해 Resource를 처리하도록 설계된 아키텍쳐를 의미한다.

웹의 모든 자원에 고유한 ID인 HTTP URI 를 부여한다.

---

📍REST의 구성

1. 자원(Resource) - URL

• 행위(Verb) - Http Method

• 표현(Representations)

• 자원 (Resource) URL

모든 자원에 고유한 ID가 존재하고, 이 자원은 Server에 존재한다.

자원을 구별하는 ID는 /orders/order_id/1 와 같은 HTTP URI 이다.

2. 행위 (Verb) - Http Method

HTTP 프로토콜의 Method를 사용한다.

HTTP 프로토콜은 GET, POST, PUT, DELETE와 같은 메서드를 제공한다.

3. 표현 (Representaion of Resource)

Client가 자원의 상태 (정보)에 대한 조작을 요청하면 Server는 이에 적절한 응답 (Representation)을 보낸다

REST에서 하나의 자원은 JSON, XML, TEXT, RSS 등 여러 형태의 Representation으로 나타낼 수 있다.

현재는 JSON으로 주고 받는 것이 대부분이다.

---

📍package.json

프로젝트의 정보를 정의하고, 의존하는 패키지 버전 정보를 명시하는 파일이다.

일반적으로 루트 디렉토리에 위치한다.

작성되는 정보를 크게 2개로 나누면 프로젝트 정보, 패키지 정보로 나눌 수 있다.

• 프로젝트의 정보 : name, version의 영역
• 패키지 버전 정보: dependencies 또는 devDependencies 영역

📍프로젝트 정보

package.json 파일은 반드시 name과 version 항목을 포함해야합니다.

name: 소문자 한 단어로 이루어져야한다.
그리고 하이픈( - )과 언더스코어( _ )가 포함될 수 있다.

versoin: x.x.x 형식을 따라야 하며, 작성 규칙을 시맨틱 버저닝이라고 한다.

📍패키지 정보

패키지 정보는 dependencies 또는 devDependencies에 작성된다.

• "dependencies": 프로덕션 환경에서 응용 프로그램에 필요한 패키지.
• "devDependencies": 로컬 개발 및 테스트에만 필요한 패키지.