데브코스 웹풀스택 과정/TIL

[8기 9회차] 0911 백엔드 기초 - API와 REST API, HTTP와 URL 메소드

thinktank911 2025. 9. 11. 09:17

API란? (인터페이스)

  • 백엔드 개발자는 API(Application Programming Interface)를 만든다.
  • 소프트웨어 애플리케이션 간에 데이터와 기능을 교환하고 상호 작용할 수 있도록 하는 일련의 규칙, 프로토콜 및 정의를 의미
  • 개발자가 프로그램을 만드는데 필요한 어떤 기능을 직접 구현하지 않고 API 제공자들이 제공하는 데이터와 모듈 등을 갖다쓸 수 있게 해주는 게 API와 API 문서이다.

*인터페이스

  • 중간에서 양쪽에 있는 것을 중재/매개체가 되어주는 역할
  • GUI : Graphic User Interface
    • 컴퓨터 프로그램한테 명령 내릴 때, 그래픽을 사용해서 명령을 내리는 방식
  • CLI : Command Line Interface
    • 명령어 문장 컴퓨터한테 명령을 내리는 거

 

REST API란?

  • 웹개발자는 인터넷 통신 규약 즉, HTTP를 지켜야 한다.
  • REST API : HTTP 규약을 잘 따른 API
  • RESTful API : HTTP 규약을 매우 잘 따른 API

 

*REST API의 주요 특징


1) Uniform (유니폼 인터페이스)
Uniform Interface는 URI로 지정한 리소스에 대한 조작을 통일되고 한정적인 인터페이스로 수행하는 아키텍처 스타일을 말합니다. ​

2) Stateless (무상태성)
REST는 무상태성 성격을 갖습니다. 다시 말해 작업을 위한 상태정보를 따로 저장하고 관리하지 않습니다. 세션 정보나 쿠키정보를 별도로 저장하고 관리하지 않기 때문에 API 서버는 들어오는 요청만을 단순히 처리하면 됩니다. 때문에 서비스의 자유도가 높아지고 서버에서 불필요한 정보를 관리하지 않음으로써 구현이 단순해집니다. ​

3) Cacheable (캐시 가능)
REST의 가장 큰 특징 중 하나는 HTTP라는 기존 웹표준을 그대로 사용하기 때문에, 웹에서 사용하는 기존 인프라를 그대로 활용이 가능합니다. 따라서 HTTP가 가진 캐싱 기능이 적용 가능합니다. HTTP 프로토콜 표준에서 사용하는 Last-Modified태그나 E-Tag를 이용하면 캐싱 구현이 가능합니다. ​

4) Self-descriptiveness (자체 표현 구조)
REST의 또 다른 큰 특징 중 하나는 REST API 메시지만 보고도 이를 쉽게 이해 할 수 있는 자체 표현 구조로 되어 있다는 것입니다. ​

5) Client - Server 구조
REST 서버는 API 제공, 클라이언트는 사용자 인증이나 컨텍스트(세션, 로그인 정보)등을 직접 관리하는 구조로 각각의 역할이 확실히 구분되기 때문에 클라이언트와 서버에서 개발해야 할 내용이 명확해지고 서로간 의존성이 줄어들게 됩니다. ​

6) 계층형 구조
REST 서버는 다중 계층으로 구성될 수 있으며 보안, 로드 밸런싱, 암호화 계층을 추가해 구조상의 유연성을 둘 수 있고 PROXY, 게이트웨이 같은 네트워크 기반의 중간매체를 사용할 수 있게 합니다.

출처: https://inpa.tistory.com/entry/WEB-🌐-REST-API-정리#1_uniform_유니폼_인터페이스
[Inpa Dev 👨‍💻:티스토리]

 

HTTP에 담아 보내야 할 것들

  • 인터넷상 공유/전달하고 싶은 모든 것들은 다 HTTP에 넣어서 보내야 한다.
  • Body
    1) 전달해줄 데이터 / 화면 / ..
    2) 이 데이터 좀 줄래? + "목적"
    ex> 전체상품리스트 +"조회" /  상품 + "등록"

 

URL

  • Uniform Resource Locator. 넷상에서 웹페이지 위치 알려주는 것 뿐 아니라 데이터 연산 요청을 서버에 보내는 방법

 

URL + method 연습

URL 연습

http://localhost:8888/ "POST"/product - 상품 등록
http://localhost:8888/ "GET"/products - 전체 상품 조회
http://localhost:8888// "DELETE"/products - 전체 상품 삭제

 

<REST API URL 규칙>

  • 소문자
  • 언더바(_) 사용 X 하이픈(-) O
  • 마지막에 / 포함 X
  • 행위(목적) 포함 X
  • 파일 확장자 포함 X
  • 복수형을 쓴다

 

API 사용법 (화면 실습)

  • 쇼핑몰 메인페이지 > 전체상품조회 API > 전체 상품 데이터 수신 > 받은 데이터로 화면 출력
  • 상품 상세 페이지 > 상품1 개별 조회 API > 데이터 수신 > 화면 출력
  • 상품 관리 페이지 > 전체상품조회 API > 전체 상품 데이터 수신 > 받은 데이터로 화면 출력
  • 상품 수정 페이지 > 상품1 개별 조회 API // 완료 버튼 > 삼품1 수정 API

 

URL + method 실습 = API 설계

  1. 상품 전체 조회(GET) : (http://localhost:8888)/prodocts
  2. 상품 id 개별 조회(GET) : (http://localhost:8888)/prodocts /{id}
  3. 상품 개별 수정(PUT) : (http://localhost:8888)/prodocts /{id}

 

cf. 복수형 표현 이유 : 상품 중 하나라는 어감 / 통일감