1. API의 종류
API는 어디서 어떻게 제공되느냐에 따라 여러 형태로 나뉨
Open API : 사용할 수 있는 공개된 API
EX) Kakao Map API
Private API 내부 시스템에서만 사용하는 API
EX) 관리자 시스템 등
Partner API 특정 파트너에만 제공되는 API
EX) 결제대행 API
2. RESTful API란?
REST는 API 설계의 일종 / 리소스를 중심으로 설계된 구조
RESTful API의 특징
URL은 명사 중심 (자원) → /users, /posts/3/comments
HTTP 메서드로 동작 구분 → GET, POST, PUT, DELETE
무상태성 (Stateless) → 요청 간 상태를 서버가 기억하지 않음
계층화 (Layered) → 중간 서버(캐시, 프록시 등)를 둘 수 있음
3. GraphQL API란?
REST와는 다른 방식으로 데이터를 주고받는 API
4. Webhook이란?
API는 보통 클라이언트가 서버에 요청하는 방식
Webhook은 서버가 클라이언트에 이벤트 발생 시 자동 전송하는 방식
EX) 결제 완료 시, 카카오 알림톡이 자동으로 전송되는 구조
5. API 응답 구조 (표준화)
{
"success": true,
"data": {
"id": 1,
"name": "홍길동"
},
"error": null
}
6. API Gateway란?
여러 개의 API 서비스를 하나로 통합해서 관리하는 중간 관리자 역할을 하는 서버
주요 기능
라우팅 (요청 전달)
인증/인가 처리
요청 제한(Rate Limiting)
로깅/모니터링