API(application programming interface)의 줄임말로 응용 프로그램에서 사용할 수 있도록, 운영 체제나 프로그래밍 언어가 제공하는 기능을 제어할 수 있게 만든 인터페이스를 의미한다.
위키백과 - API
REST는 “Representational State Transfer”의 약자로, 웹에서 사용되는 데이터나 자원(Resource)을 URI로 표현하고, HTTP 프로토콜을 통해 요청과 응답을 정의하는 방식을 말합니다.
0단계: 단순하게 HTTP 프로토콜을 사용한 단계로 REST API를 작성하기 위한 사전 준비 단계
1단계: 개별 리소스(Resource)와의 통신을 준수하여 작성하는 단계
2단계: CRUD에 맞게 적절한 HTTP 메서드를 사용하여 작성하는 단계
CRUD | Method | 설명 |
---|---|---|
Creeate | POST | 새로운 리소스를 생성할때 사용 |
Read | GET | 서버에 데이터를 요청할때 사용. 서버에는 변화가 없는 요청이어야함 |
Update | PUT / PATCH | 서버의 리소스를 교체할때는 PUT, 수정할때는 PATCH 를 사용해야함 |
Delete | DELET | 리소스를 삭제하는 삭제할 때 사용 |
Open API는 쉽게 말해 누구에게나 열려있는 API를 말합니다. 공공데이터 포털의 공공데이터가 Open API 형태로 제공하고 있는 대표적인 예입니다. 물론, API마다 정책에 따라 사용의 제한 사항이 존재하기도 합니다. 이때 권한을 확인하기 위해 API Key
라는 것이 필요하기도 합니다.
이용자 발급하는 고유한 Key(값)으로 각각의 이용자마다 부여된 자원의 접근 권한을 확인하는 용도로 사용합니다. 이를 통해 권한이 있는 이용자에게만 API를 제공합니다.