REST API / OPEN API

REST API

REST API는 다른 서버에서 데이터를 가져올 때 (HTTP를 이용하여 통신할 때), HTTP의 기능들을 최대한 활용해서 웹의 장점을 최대로 활용할 수 있는 아키텍처이다.

REST API를 설계 할 때

먼저 REST의 구성은 아래와 같다.

• 자원(resource)
• 행위(HTTP Method)
• 표현

REST API를 설계할 때의 규칙으로 2가지를 나타낼 수 있다.
1. URI는 정보의 자원을 표현해야 한다 ( 행위의 표현을 사용하지 말아야 한다)
2. 자원에 대한 행위를 HTTP Method(GET, POST 등..) 으로 표현한다.

예를들어 블로그의 id가 1인 글을 삭제하고 싶을 때에는..

GET /topic/delete/1 
// 위의 코드는 옳지 않는 방법이다.

DELETE /topic/1
// 삭제라는 행위를 Delete라는 메소드를 이용하여 표현한 옳은 방법이다.

HTTP Method 역할

• GET : 리소스를 조회하고 자세한 정보를 가져올 때
• POST : 요청하면 리소스를 생성한다
• PUT : 리소스를 수정한다
• DELETE : 리소스를 삭제한다

정리 : URI는 자원의 표현에만 집중하며, 행동은 HTTP Method를 이용한다. 이것이 REST한 API를 만드는 중심규칙이다.

OPEN API

OPEN API는 공개된 API를 뜻하며, 누구나 사용 가능하지만 API마다 이용 수칙이 있으며, 가격 / 정보 등..의 제한이 있을 수도 있다.

대표적인 OPEN API 사이트

• 공공 데이터 포털
• 카카오
• 라이엇

API KEY

API KEY는 인증 토큰만큼 안전하지는 않지만, API를 호출하는 애플리케이션이나 프로젝트를 식별하며, 프로젝트에서 API가 사용 설정되었는지 여부를 확인합니다.

사용하는 이유

• API 호출 수를 제어하기 위해서
• 익명 트래픽을 차단하기 위해서