Web API란? (엔드포인트, 메서드: GET, POST, PUT, DELETE, 헤더, 바디)

 

API란?

API(Application Programming Interface)란,
쉽게 말해, 소프트웨어끼리 서로 대화할 수 있도록 도와주는 규칙이나 방법이라고 생각하면 된다.
 

Web API란?

Web API는 인터넷을 통해 데이터를 주고받기 위해 사용되는 API다.
웹사이트나 앱이 서버와 정보를 교환할 수 있게 해 준다.
 
 

Web API의 작동 방식

요청(Request)
예를 들어, 앱에서 "피자 하나 주문할게요"라고 버튼을 누르면,
음식 배달 앱이 레스토랑의 서버에 이 주문 정보를 보낸다. 이 과정이 요청이다.
Web API에서는 클라이언트(예: 당신의 앱)가 서버(예: 웹사이트)에게
특정 데이터를 요청하거나 작업을 수행하라고 지시한다.
 
처리(Processing)
레스토랑의 서버는 주문 정보를 받고, 주문을 처리하기 시작한다.
(요리를 하고 배달 준비를 한다.)
서버는 요청을 처리하여 필요한 데이터를 준비한다.
 
응답(Response)
레스토랑이 음식을 준비하고 배달을 완료하면,
배달 앱에 "주문이 완료되었습니다"라는 정보를 보낸다. 이 정보가 바로 응답이다.
Web API에서는 서버가 클라이언트에게 요청을 받고,
요청된 데이터를 클라이언트에 전달한다.
 
 

Web API의 주요 구성 요소

• 엔드포인트 (Endpoint)
  요청을 보내는 주소(URL)이다.
  예를 들어, https://api.weather.com/current처럼
  Web API에서도 이와 같은 주소를 사용하여 특정 기능이나 데이터를 요청한다.
• 메서드 (Methods) 
  데이터를 어떻게 처리할지를 결정한다.
  HTTP 메서드를 사용해서 요청을 보낸다. 가장 일반적인 메서드는 다음과 같다
  • GET 
    서버에서 데이터를 조회할 때 사용한다.(데이터 요청)
    (예: "메뉴를 보여주세요")
  • POST 
    서버에 새로운 데이터를 생성하거나 추가할 때 사용한다.(데이터 전송)
    (예: "새로운 주문을 추가해 주세요")
  • PUT 
    서버에 기존 데이터를 업데이트할 때 사용한다.(데이터 수정)
    (예: "주문 정보를 수정해 주세요")
  • DELETE 
    서버에서 데이터를 삭제할 때 사용한다.(데이터 삭제)
    (예: "주문을 취소해 주세요")
• 헤더 (Headers) 
  요청이나 응답의 메타데이터를 포함하는 정보다.
  예를 들어, 인증 정보나 데이터 형식 등이 헤더에 포함될 수 있다.
• 바디 (Body) 
  요청이나 응답의 실제 데이터가 포함된 부분이다.
  예를 들어, 요청할 데이터의 내용이나 서버가 반환하는 데이터의 내용이 여기에 포함된다.

 
Recap

• Web API는 웹을 통해 애플리케이션 간의 소통을 가능하게 해주는 도구이다.
• 음식 배달 앱처럼, Web API를 사용하면 클라이언트가 서버에 요청을 보내고,
  서버는 그 요청을 처리하여 응답을 반환한다.
• 정보 요청과 응답을 통해 서로 다른 시스템이 데이터와 기능을 주고받을 수 있게 해 준다.