HTTP

REST API

웹에서 사용되는 데이터나 자원(Resource)을 HTTP URI로 표현하고

HTTP 프로토콜을 통해 요청과 응답을 정의하는 방식

API가 수행해야하므로 서로 잘 알아볼 수 있도록 작성해야한다.

 

좋은 REST API 디자인 하는 방법

0단계 - HTTP프로토콜 사용

 

1단계 - 개별 리소스에 맞는 엔드포인트를 사용해야한다, 요청하고 받은자원에 대한 정보를 응답으로 전달

엔드포인트 작성시 리소스에 집중해 명사형태 단어로 작성

 

2단계 - CRUD에 맞게 적절한 HTTP메서드 사용, 응답코드 명확하게 작성, 관련리소스를 클라이언트가 Location 헤더에 작성된 URI를 통해 확인할수있도록 해야함

메서드 사용규칙

GET : 서버의 데이터를 변화시키지 않는 요청에 사용

POST : 요청마다 새로운 리소스를 생성 멱등x

/ PUT은 요청마다 같은 리소스를 반환 - 매 요청마다 같은 리소스를 반환하는 특징을 멱등(idempotent)하다고 한다

PUT과 PATCH도 구분해야한다 PUT은 교체 PATCH는 수정

 

3단계 - HATEOAS 하이퍼미디어컨트롤

응답에는 리소스의 URI를 포함한 링크요소를 삽입하여 작성한다 - 새로운 기능에 접근할 수 있도록 하는것

 

 

Open API 

정부에서 제공하는 공공데이터, 쉽게 접근 할수있게 Open API 형태로 공공데이터 제공

 

API Key

API를 이용하기 위한 key

 

HTTP API 테스트 도구

Postman

HTTP로 소통하기 위해서 API 서버의 endpoint가 URL로 주어져야한다

 

Postman으로 날씨 받아오기

양산 날씨!! (서울은 1835848 입력)