🍋
Menu
General

API

API (Application Programming Interface)

서로 다른 소프트웨어 애플리케이션이 서로 통신할 수 있도록 하는 정의된 규칙과 프로토콜의 집합으로, 개발자가 서비스의 내부 동작을 이해하지 않고도 기능이나 데이터에 접근할 수 있게 합니다.

기술 세부사항

웹 API는 일반적으로 JSON 페이로드와 함께 HTTP 메서드(GET, POST, PUT, DELETE)를 사용하는 REST 아키텍처 스타일을 따릅니다. 주요 설계 원칙에는 상태 비저장성, 리소스 기반 URL, 적절한 HTTP 상태 코드, 버전 관리(URL 경로 또는 헤더)가 포함됩니다. 인증 방법은 API 키와 OAuth 2.0 토큰에서 JWT(JSON Web Token)까지 다양합니다. GraphQL은 클라이언트가 필요한 데이터를 정확히 지정할 수 있는 대체 쿼리 언어를 제공합니다. 프로덕션 API에는 속도 제한, CORS 헤더, 페이지네이션이 필수입니다.

예시

```javascript
// API: file processing example
const file = document.getElementById('fileInput').files[0];
const reader = new FileReader();
reader.onload = (e) => {
  const data = e.target.result;
  console.log(`Loaded: ${file.name} (${file.size} bytes)`);
};
reader.readAsArrayBuffer(file);
```

관련 용어