API

API (Application Programming Interface)

1. 개념

API는 응용 프로그램 간 상호작용을 가능하게 하는 인터페이스를 의미함.

즉, 한 프로그램이 다른 프로그램의 기능이나 데이터를 정해진 방식으로 요청하고 응답받기 위한 규약(Protocol) 임.

서로 다른 시스템 간 통신을 단순화하고, 기능을 재사용할 수 있도록 설계됨.

---

2. 특징

• 프로그램 간 데이터 교환 및 기능 호출을 표준화함
• 내부 로직을 숨기고, 필요한 기능만 외부에 공개함 (캡슐화 개념과 유사)
• 플랫폼과 언어에 독립적으로 동작함
• JSON, XML 등을 통해 데이터 전달
• 요청(Request)과 응답(Response) 구조로 동작

---

3. 구성 요소

구성 요소	설명
Endpoint	API가 요청을 받는 URL 주소
Method	동작을 정의하는 방식 (GET, POST, PUT, DELETE 등)
Header	요청/응답의 부가 정보 (Content-Type, 인증 토큰 등)
Body	실제 전달되는 데이터 (보통 JSON 형태)
Status Code	요청 결과를 나타내는 코드 (200, 404, 500 등)

---

4. 동작 원리 예시

요청 → 처리 → 응답 흐름

GET /api/users/1
Response:
{
  "id": 1,
  "name": "Hyebin",
  "role": "Backend Developer"
}

---

5. API 종류

구분	설명	예시
Open API	외부 개발자에게 공개된 API	카카오맵 API, 네이버 로그인 API
Private API	내부 시스템 간 통신용	사내 결제 시스템, 인증 서버 API
Partner API	특정 파트너 기업에게만 제공	결제 대행사 API, 물류 연동 API

---

6. REST API

REST (Representational State Transfer) 는 웹 기반 시스템에서 가장 널리 쓰이는 API 아키텍처 스타일로,

리소스 중심의 URL 설계와 HTTP 표준 메서드(GET, POST, PUT, DELETE) 를 사용함.

 

특징 요약

• 자원(Resource)을 URI로 표현 (/users, /posts)
• 상태(STATE)를 포함하지 않는 무상태(Stateless) 구조
• 요청 방식에 따라 CRUD 동작 수행
• 응답은 일반적으로 JSON 형식 사용

Method	역할	예시
GET	데이터 조회	/users
POST	데이터 생성	/users
PUT	데이터 수정	/users/1
DELETE	데이터 삭제	/users/1

---

7. API 통신 예시 (Client ↔ Server)

1. 클라이언트가 특정 URL로 요청 보냄 (GET /api/users)
2. 서버가 요청을 받아 데이터 처리
3. 서버가 결과를 JSON으로 응답 (200 OK)
4. 클라이언트가 응답 데이터를 화면에 표시

---

8. 면접 포인트 정리

• API는 시스템 간 데이터를 주고받기 위한 인터페이스
• 내부 로직을 숨기고 필요한 기능만 외부에 제공 (캡슐화)
• REST API는 HTTP 기반의 가장 보편적인 아키텍처 스타일
• REST API 설계 시 자원 중심, 명확한 URI, 일관된 규칙이 중요
• 응답 데이터는 대부분 JSON 포맷으로 전달
• 상태 코드를 통해 요청 성공/실패 여부를 명확히 전달

---

핵심 요약

API는 서로 다른 시스템 간의 소통을 위한 규약이며,
REST API는 HTTP 기반의 대표적인 설계 방식으로,
요청-응답 구조와 JSON 데이터 교환을 통해 클라이언트와 서버를 연결함.