응용 프로그래밍 인터페이스 (Application Programming Interface, API)

응용 프로그래밍 인터페이스(API)는 한 프로그램이 다른 프로그램의 기능이나 데이터를 정해진 규칙에 따라 요청하고 응답받을 수 있게 하는 접점입니다.

자세히 알아보기

API는 "어떤 요청을, 어떤 형식으로 보내면, 어떤 응답이 돌아오는지"를 약속한 규격입니다. 내부 구현을 몰라도 규격만 지키면 다른 시스템의 기능을 쓸 수 있으므로, 서비스끼리 연결하고 자동화하는 데 필수적입니다. 운영체제의 시스템 호출, 프로그래밍 언어의 라이브러리 함수, 인터넷을 통해 호출하는 웹 API가 모두 API에 해당합니다.

웹 API는 보통 HTTP 위에서 동작합니다. 자원을 URL로 표현하는 REST, 함수 이름과 인자를 JSON으로 보내는 JSON-RPC, 질의 언어를 쓰는 GraphQL, 실시간 데이터를 계속 밀어 주는 WebSocket 방식이 널리 쓰입니다. 응답 형식은 대부분 JSON입니다.

API를 공개하는 쪽은 인증(API 키, OAuth), 호출 횟수 제한(rate limit), 버전 관리를 함께 설계합니다. 쓰는 쪽은 상대 서비스의 장애·변경에 의존하게 되므로, 오류 처리와 재시도를 준비해야 합니다.

블록체인·암호화폐에서는

• 노드 API: 이더리움 노드는 eth_getBalance, eth_sendRawTransaction 같은 JSON-RPC 메서드를, 비트코인 코어는 getblock, sendrawtransaction 같은 RPC를 제공합니다. 지갑과 디앱은 이 API로 잔고를 조회하고 트랜잭션을 전송합니다.
• 거래소 API: 시세·호가 조회, 주문, 입출금을 프로그램으로 처리합니다. 자동매매에 쓰이며, API 키가 유출되면 계정이 탈취될 수 있으므로 출금 권한을 끄고 IP 허용 목록을 거는 것이 기본 수칙입니다.
• 탐색기·분석 API: 블록 탐색기와 스캐너는 주소 이력, 토큰 전송, USDT 동결 이벤트 같은 데이터를 API로 제공해 다른 서비스가 가져다 쓰게 합니다.

API 보안 수칙

API는 편리한 만큼 공격 경로가 되기도 합니다. 서버 쪽에서는 입력값 검증, 인증·권한 분리, 호출 횟수 제한, 전송 구간 암호화(HTTPS)가 기본입니다. 클라이언트 쪽에서는 API 키를 소스 코드나 공개 저장소에 올리지 않고, 환경 변수나 비밀 관리 도구에 보관해야 합니다. 필요한 권한만 부여하는 최소 권한 원칙도 중요합니다. 시세 조회만 하는 봇이라면 주문·출금 권한이 없는 읽기 전용 키를 발급받는 것이 안전합니다.

쉽게 말하면

API는 식당의 메뉴판과 주문 창구입니다. 주방(내부 시스템)에 들어가지 않아도 메뉴에 적힌 대로 주문하면 음식이 나옵니다.

예시

GET /api/v3/ticker/price?symbol=BTCUSDT 같은 요청을 보내면 {"symbol":"BTCUSDT","price":"..."} 형태의 JSON 응답이 돌아옵니다.