[네트워크] REST API

🌱 API

API는 무엇일까요?

Application Programing Interface는 코드끼리 서로 소통하기 위해 만들어진 인터페이스라고 합니다.

비유를 하자면, 서버에서 만든 키보드와 같습니다. 특정 키가 팔로우, 로그인, 좋아요의 기능을 한다고 치면 키를 눌렀을 때 백엔드 데이터베이스로 요청을 보냅니다. 어떤 사이트에서 특정 데이터를 공유할 경우 어떤 방식으로 정보를 요청해야 하는지, 그리고 어떠한 데이터를 제공 받을 수 있을 지에 대한 규격이라고 보면 됩니다.

API는 사용하는 방법과 용도에 따라, 오픈 API와 비공개 API 정보로 구분됩니다.
오픈 API는 말 그대로 누구나 쉽게 접근하여 정보를 공유하기 위해 만들어진 규격이며,
비공개 API는 권한이 있는 일부 사용자들에게만 정보를 제공하기 위해 만들어진 규격입니다.

🌱 REST API

웹을 개발할 때 API를 만들면 REST 구조로 만들게 됩니다.
REST란 Representational State Transfer의 약자로, 자원을 이름으로 구분하여 해당 자원의 상태를 주고받는 모든 것을 의미합니다.

HTTP URI(Uniform Resource Identifier)를 통해 자원(Resource)을 명시하고, HTTP Method(POST, GET, PUT, DELETE, PATCH 등)를 통해 해당 자원(URI)에 대한 CRUD Operation을 적용하는 것을 의미합니다. 여기서 CRUD는 대부분의 컴퓨터 소프트웨어가 가지는 기본적인 데이터 처리 기능인 Create, Read, Update, Delete를 묶어서 일컫는 말로 REST에서의 CRUD Operation 동작 예시는 아래와 같습니다.

유형	기능
Create	데이터 생성, POST
Read	데이터 조회, GET
Update	데이터 수정, PUT, PATCH
Delete	데이터 삭제, DELETE

REST의 3가지 구성요소

구성 요소	매개체
자원(Resource)	HTTP URI
자원에 대한 행위(Verb)	HTTP Method
자원에 대한 행위의 내용(Representations)	HTTP Message Pay Load

REST의 특징

• Server ↔ Client
• Stateless 무상태
• Cacheable 캐시 처리 가능
• Layered System 계층화
• Uniform Interface 인터페이스 일관성

장점

HTTP 프로토콜의 인프라를 그대로 사용하므로 REST API 사용을 위한 별도의 인프라를 구축할 필요가 없습니다.
그리고 HTTP 프로토콜의 표준을 최대한 활용하여 여러 추가적인 장점을 함께 가져갈 수 있습니다.

그래서 HTTP 표준 프로토콜에 따르는 모든 플랫폼에서 사용이 가능합니다.
또, Hypermedia API의 기본을 충실히 지키면서 범용성을 보장합니다.

REST API는 메시지가 의도하는 바를 명확하게 나타내므로, 의도하는 바를 쉽게 파악할 수 있습니다.
그래서 여러 가지 서비스 디자인에서 생길 수 있는 문제를 최소화합니다.
결과적으로 서버와 클라이언트의 역할을 명확하게 분리합니다.

단점

REST API는 표준 자체가 존재하지 않아 정의가 필요합니다. 그리고 HTTP Method 형태가 제한적입니다.
또한 브라우저를 통해 테스 트할 일이 많은 서비스라면 쉽게 고칠 수 있는 URL말고 Header 정보의 값을 처리해야하므로 전문성이 요구됩니다. 구형 브라우저에서는 호환이 되지 않아 지원하지 못하는 동작도 있습니다.

REST API를 설계하는 법

• URI는 동사보다는 명사를, 대문자보다는 소문자를 사용합니다.
• 마지막에 /를 포함하지 않습니다.
• _대신 -을 사용합니다.
• 파일 확장자는 URI에 포함하지 않습니다.
• 행위를 포함하지 않습니다.