📘 API에 대해서…

API에 대해서…

1. API(Application Programming Interface)란?

API는 Application Programming Interface의 약자로,
서로 다른 소프트웨어가 기능이나 데이터를 주고받기 위해 사용하는 ‘약속된 규칙(인터페이스)’입니다.

• Application: 고유한 기능을 가진 모든 소프트웨어
• Interface: 다른 소프트웨어 또는 시스템과 통신하거나 제어할 수 있는 방법

예를 들어,

날씨 앱을 만든다고 할 때,
기상청의 API를 사용하면 직접 데이터를 수집하지 않아도 정해진 방식으로 요청만 하면 날씨 데이터를 받아올 수 있습니다.

핵심은 직접 구현하지 않아도, API를 통해 필요한 기능이나 데이터를 가져올 수 있다는 점입니다.

---

2. 인터페이스(Interface)란?

인터페이스는 두 시스템이 정보를 주고받는 연결점입니다.

자동차 브레이크 예시로 이해하기 🚗

• 1. 사용이 편리함
  운전자는 브레이크의 작동 원리를 몰라도, 단지 페달을 밟기만 하면 됩니다.

• 2. 정보 은닉
  브레이크가 실제로 작동하는 내부 구조(기계적 작동)는 운전자가 알 필요 없이 감춰져 있습니다.

인터페이스는 구현을 숨기고 사용만 가능하게 함으로써 복잡성을 줄이고 안정성을 높입니다.

---

3. API의 주요 특징

특징	설명
기능 제공	특정 기능(예: 로그인, 결제, 날씨조회 등)을 외부에 제공
정보 은닉	내부 동작 방식은 감추고, 필요한 데이터/기능만 노출
표준화된 통신	HTTP/HTTPS 기반의 통신 규약 사용 (REST, GraphQL 등)
개발 효율 향상	반복 구현 없이 재사용 가능, 빠른 개발 가능

---

4. UI와 UX의 개념

4-1. UI (User Interface)

UI는 사용자가 시각적으로 마주하게 되는 인터페이스를 말합니다.

• 버튼, 색상, 폰트, 레이아웃 등 디자인 요소
• 사용자와 소프트웨어 사이의 상호작용 창구

웹 API에서는 사용자와의 직접적인 상호작용은 없지만,
프론트엔드 개발자에게 API는 UI 요소와 데이터를 연결하는 핵심 다리입니다.

---

4-2. UX (User Experience)

UX는 사용자가 서비스를 이용하면서 느끼는 종합적인 경험과 만족도를 말합니다.

• “느낌, 태도, 행동”의 총합
• 직관적인 흐름, 빠른 반응, 사용성 등이 UX에 영향을 줍니다

API 설계 또한 UX에 큰 영향을 줍니다.
예를 들어, API 응답이 느리거나 비직관적이라면 UX는 나빠질 수밖에 없습니다.

---

5. API 중요 포인트

• 문서화 (Documentation): 어떤 요청을 어떻게 보내야 하고, 어떤 응답이 오는지 명확하게 정리
• 보안 (Authentication & Authorization): 토큰, OAuth 등으로 사용자의 접근 제어
• 버전 관리 (Versioning): 기존 사용자에 영향을 주지 않기 위한 v1, v2 등 관리
• 테스트 및 예외 처리: 다양한 상황을 고려한 안정성 확보

---