API - REST API

🕐REST API

REST(Representational State Transfer)의 약자로 자원을 이름으로 구분하여 해당 자원의 상태를 주고받는 모든 것을 의미합니다.

REST는 다음과 같은 3가지로 구성되어 있습니다.

1. 자원(Resource) : HTTP URL
2. 자원에 대한 행위(Verb) : HTTP Method
3. 자원에 대한 행위의 내용 (Representations) : HTTP Message Pay Load

장점 & 단점

장점

• HTTP프로토콜의 인프라를 그대로 사용하므로 REST API 사용을 위한 별도의 인프라를 구축할 필요가 없다.
• HTTP 프로토콜의 표준을 최대한 활용하여 여러 추가적인 장점을 함께 가져갈 수 있게 해 준다.
• HTTP 표준 프로토콜에 따르는 모든 플랫폼에서 사용이 가능하다.
• Hypermedia API의 기본을 충실히 지키면서 범용성을 보장한다.
• REST API 메시지가 의도하는 바를 명확하게 나타내므로 쉽게 파악 가능하다.
• 여러 가지 서비스 디자인에서 생길 수 있는 문제를 최소화한다.
• 서버와 클라이언트의 역할을 명확하게 분리한다.

단점

• 표준이 자체가 존재하지 않아 정의가 필요하다.
• 사용할 수 있는 메소드가 4가지밖에 없다.
• HTTP Method 형태가 제한적이다.
• 브라우저를 통해 테스트할 일이 많은 서비스라면 쉽게 고칠 수 있는 URL보다 Header 정보의 값을 처리해야 하므로 전문성이 요구된다.
• 구형 브라우저에서 호환이 되지 않아 지원해주지 못하는 동작이 많다.(익스플로러)

🕑Google Books APIs 사용하기

위 내용을 바탕으로 vsCode에서 API를 호출해보겠다.

vsCode에서 API 호출

get https://www.googleapis.com/books/v1/volumes?q=intitle=숨그네

API호출 결과

🕒REST API의 자원 표현을 위한 URL 설계 규칙

1. 소문자만 사용
2. 하이픈[-]은 사용하지 않고 밑줄[-]을 사용
3. 확장자를 표시하지 않음

🕓파라미터를 지정한 후 API호출

파라미터를 지정할 때는 ?[물음표]를 적고 조건을 기입한다.

get https://yts.mx/api/v2/list_movies/json
	?minimum_rating=8.5
    &sort_by=year
    $limit=1