API

API(application programming interface)는 다른 소프트웨어 시스템과 통신하기 위해 따라야 하는 규칙을 정의합니다.

개발자는 다른 애플리케이션이 프로그래밍 방식으로 애플리케이션과 통신할 수 있도록 API를 표시하거나 생성합니다.

 

인터페이스(Interface)는 서로 다른 두 개의 시스템, 장치 사이에서 정보나 신호를 주고받는 경우의 접점이나 경계면을 의미합니다.

 

RESTful API

- Representatinal State Transger(REST)는 API 작동 방식에 대한 조건을 부과하는 소프트웨어 아키텍처 입니다.

- REST는 처음에 인테넛과 같은 복잡한 네트워크에서 통신을 관리하기 위한 지침으로 만들어졌습니다.

- REST 아키텍처 스타일을 따르는 API를 REST API라고 합니다.

- REST 아키텍처를 구현하는 웹 서비스를 RESTful 웹 서비스라고 합니다.

=> API가 적절하게 http를 준수하며 잘 설계되어있으면 RESTful 하게 설계되어 있는것과 동일하다.

• 고유 리소스 식별자
  - 서버는 고유한 리소스 식별자로 각 리소스를 식별합니다. REST 서비스의 경우 서버는 일반적으로 URL을 사용하여 리소스 식별을 수행합니다.
  - URL은 리소스에 대한 경로를 지정합니다. URL은 웹페이지를 방문하기 위해 브라우저에 입력하는 웹 사이트 주소와 유사합니다.
  - URL은 요청 엔드포인트라고도 하며 클라이언트가 요구하는 사항을 서버에 명확하게 지정합니다.
• 메서드
  - 개발자는 종종 http를 사용하여 RESTful API를 구현합니다. HTTP메서드는 리소스에 수행해야 하는 작업을 서버에 알려줍니다. 다음은 4가지(GET, POST, PUT,DELETE)의 일반적인 HTTP 메서드 입니다.
• GET
  - 클라이언트는 GET을 사용하여 서버의 지정된 URL에 있는 리소스에 엑세스합니다. GET요청을 캐싱하고 RESTful API 요청에 파라미터를 넣어 전송하여 전송 전에 데이터를 필터링하도록 서버에 지시할 수 있습니다.
• POST
  - 클라이언트는 POST를 사용하여 서버에 데이터를 전송합니다. 여기에는 요청과 함께 데이터 표현이 포함됩니다.   동일한 POST 요청을 여러 번 전송하면 동일한 리소스를 여러 번 생성하는 부작용이 있습니다.
• PUT
  - 클라이언트는 PUT을 사용하여 서버의 기존 리소스를 업데이트합니다. POST와 달리, RESTful 웹 서비스에서 동일한 PUT 요청을 여러 번 전송해도 결과는 동일합니다.
• DELETE
  - 클라이언트는 DELETE 요청을 사용하여 리소스를 제거합니다. DELETE 요청은 서버 상태를 변경할 수 있습니다.  하지만 사용자에게 적절한 인증이 없으면 요청은 실패합니다. => CRUD에서 Create는 POST, Read는 GET, Update는 PUT, Delete는 DELETE 메서드를 사용합니다.