🎯 REST API 개념과 올바른 URL 설계 원칙을 이해하고 정리합니다.

📙 Today I Learned

API (Application Programming Interface)

다른 소프트웨어 시스템을 중간에서 연결하고 데이터를 주고받을 수 있도록 해주는 인터페이스입니다.

인터페이스(interface)
서로 다른 시스템이 소통할 수 있도록 중재하는 역할입니다.

• 예시
  • CLI (Command Line Interface)
  • GUI (Graphic User Interface)

REST API

REST 원칙을 따르는 API입니다.

REST (Representational State Transfer)
웹에서 데이터를 주고받는 약속(규칙)입니다.

올바른 REST API URL 규칙

• 소문자 사용

• 언더바 _ 대신 하이픈 - 사용

• URL 끝에 /(슬래시) 넣지 않기

• 파일 확장자 넣지 않기

• 리소스명은 복수형으로 사용(/products ✅, /product ❌)

• 행위 포함 ❌ (→ GET, POST로 구분 )

RESTful API

REST 원칙을 완벽하게 지킨 API 입니다.

• CRUD에 맞게 GET, POST, PUT, DELETE 사용합니다.
• 무상태(Stateless) 원칙(요청 간에 상태를 유지하지 않음)을 반드시 따릅니다.

CRUD
데이터를 다루는 4가지 기본 기능으로 Create(생성), Read(조회), Update(수정), Delete(삭제)의 앞글자를 따서 CRUD라고 합니다.

HTTP (HyperText Transfer Protocol)

웹에서 클라이언트(사용자)와 서버(컴퓨터)가 데이터를 주고받는 프로토콜(약속)입니다.

💡 웹에서 주고받는 모든 데이터는 HTTP 프로토콜을 통해 전송됩니다.

HTTP Method

클라이언트가 서버에 어떤 요청을 보낼지 결정하는 방식입니다.

HTTP Method	역할	URL 예시
GET	데이터 조회	/products (전체 상품 조회) /products/{id} (특정 상품 조회)
POST	데이터 추가	/products (새 상품 추가)
PUT	데이터 전체 수정	/products/{id} (상품 전체 수정)
PATCH	데이터 부분 수정	/products/{id} (상품 일부 수정)
DELETE	데이터 삭제	/products/{id} (상품 삭제)

URL (Uniform Resource Locator)
인터넷 상에서 웹페이지가 어디있는지 위치를 알려주는 것뿐 아니라 서버에 요청을 보내 데이터 연산을 수행하는 방법입니다.

📌 왜 POST 요청에는 ID가 필요하지 않을까?

• 새 데이터를 추가할 때 자동으로 ID를 생성하는 기능을 제공하기 때문에 서버가 새로운 리소스를 만들고, 자동으로 ID를 부여합니다.
• 생성된 ID는 POST 요청의 응답에서 확인할 수 있습니다.

🧐 오늘의 발견

• REST API URL을 설계할 때 GET, POST 같은 HTTP 메서드를 활용해야 한다는 점을 배웠습니다.
• POST 요청에는 id가 필요하지 않고 데이터베이스에서 자동으로 생성해주는 기능을 제공해준다는 것을 알았습니다.

🖋️ 한 줄 회고

API의 종류에 정리하면서 RESTful API 규칙을 더 신경 써서 지켜야겠다고 느꼈습니다!