IT 용어_API

API 개념

    API(Application Programming Interface)는 컴퓨터나 컴퓨터 프로그램 사이의 연결이다. 정의 및 프로토콜 집합을 사용하여 두 소프트웨어 구성 요소가 서로 통신할 수 있게 하는 메커니즘이다. 이러한 연결이나 인터페이스를 빌드하거나 사용하는 방법을 기술하는 문서나 표준은 API 사양으로 부른다. 이 표준을 충족하는 컴퓨터 시스템은 API가 구현(implement)되었다거나 노출(expose)되었다고 말한다. API라는 용어는 사양이나 구현체를 의미할 수 있다. 예를 들어, 기상청의 소프트웨어 시스템에는 일일 기상 데이터가 들어 있다. 휴대폰의 날씨 앱은 API를 통해 이 시스템과 '대화'하여 휴대폰에 매일 최신 날씨 정보를 표시한다.

    컴퓨터와 인간을 연결하는 사용자 인터페이스와는 반대로, API는 컴퓨터나 소프트웨어를 서로 연결한다. 직접 사람(최종 사용자)에 의해 사용되도록 고안된 것이 아니며, 대신 소프트웨어에 이를 통합하고자 하는 컴퓨터 프로그래머가 사용하도록 고안되었다. API는 각기 다른 부분으로 구성되기도 하며 프로그래머가 사용할 수 있는 도구나 서비스의 역할을 한다. 이러한 부분들 중 하나를 사용하는 프로그램이나 프로그래머는 API의 해당 부분을 호출(call)한다고 말한다. API를 구성하는 호출들은 서브루틴, 메소드(method), 요청(request), 통신 엔드포인트라고도 부른다. API 사양은 이 호출들을 정의하며, 다시 말해 이들을 어떻게 사용하거나 구현하는지를 설명한다는 것을 의미한다.

    API는 대부분 비즈니스 사용자에게는 보이지 않지만 소프트웨어 프로그램에 대한 다양한 가능성을 열어준다. API는 통제된 방식으로 소프트웨어의 기능과 데이터의 작은 부분을 열어 작동한다. 이를 통해 개발자는 전체 시스템의 코드에 액세스할 필요 없이 해당 프로그램, 하드웨어, 데이터 또는 앱에 액세스 할 수 있다.

    API의 한 가지 목적은 시스템이 동작하는 방식에 관한 내부의 세세한 부분을 숨기는 것으로, 내부의 세세한 부분이 나중에 변경되더라도 프로그래머가 유용하게 사용할 수 있고 일정하게 관리할 수 있는 부분들만 노출시킨다. API는 특정 시스템용으로 커스텀하게 빌드될 수도 있고, 아니면 수 많은 시스템 간 상호운용성을 허용하는, 공유가 되는 표준일 수도 있다.

    API라는 용어는 웹 API를 의미하기도 하며, 이는 인터넷에 의해 병합된 컴퓨터들 간 통신을 허용한다. 프로그래밍 언어, 소프트웨어 라이브러리, 컴퓨터 운영 체제, 컴퓨터 하드웨어를 위한 API도 존재한다.  

    API의 맥락에서 애플리케이션이란 단어는 고유한 기능을 가진 모든 소프트웨어를 나타낸다. 인터페이스는 두 애플리케이션 간의 서비스 계약이라고 할 수 있다. 이 계약은 요청과 응답을 사용하여 두 애플리케이션이 서로 통신하는 방법을 정의한다. API 문서에는 개발자가 이러한 요청과 응답을 구성하는 방법에 대한 정보가 들어 있다.

    API 아키텍처는 일반적으로 클라이언트와 서버 측면에서 설명된다. 요청을 보내는 애플리케이션을 클라이언트라고 하고 응답을 보내는 애플리케이션을 서버라고 한다. 따라서 날씨 예에서 기상청의 날씨 데이터베이스는 서버이고 모바일 앱은 클라이언트이다.

    라이브러리와 종종 헷갈리곤 하는데 엄밀히 말하면 서로 다르다. API는 소프트웨어 개발에서 호환성을 위해 지켜야 하는 추상적인 원칙이다. 라이브러리는 이러한 API들을 기반으로 개발자에게 기능을 제공할 수 있도록 실제 구현된 구현체다. API는 여러 기업과 개발자들이 서로의 프로그램이 호환되도록 합의한 원칙이다. 라이브러리는 실제 이를 바탕으로 구현된 결과물이다. 대개의 경우 독립된 응용 프로그램(Application) 간의 상호작용은 '이미 구현된 코드'의 재사용이기 때문에 라이브러리는 다시 쓰기 위해 미리 짜 놓은 코드 뭉치들을 의미하는 것이고, API를 기반으로 구현되었다고 볼 수 있다.

    API가 실제 기능 구현체인 라이브러리와 함께 제공되는 경우도 있으며, 이 경우를 SDK(Software Development Kit)라고 한다. SDK는 일반적으로 API, 라이브러리와 함께 프로그램을 개발하는데 필요한 여러 보조 프로그램을 포함한다. 한마디로 API는 소스 코드 수준에서 정의되는 인터페이스라고 할 수 있다.

 

예시

    예를 들어 명령어 창에 "Hello, World!" 라는 문자열을 출력하는 프로그램을 C언어로 작성한다고 하자. 당연히 텍스트로 출력하는 printf("Hello, World!");라고 작성하게 될 것이며, 이는 윈도우, 리눅스, 유닉스, OS X 모두에서 동일하게 동작하도록 C언어 API가 보장해준다. 이 'printf'라는 것은 API를 기반으로 설계된 문법이며, 이런 것들이 여러 개 쌓여 '라이브러리'가 된다. 물론 printf 같은 기본적인 것들은 다 기본적으로 탑재되어있기 때문에 따로 이것을 '라이브러리'라고 부르진 않지만 좀 더 나아가면 운영체제의 종류나 버전을 출력한다든가 파일의 데이터를 읽어오는 등의 행동에는 별도의 라이브러리를 호출할 필요가 있다.

    API가 없다면 프로그래머는 보다 저수준으로 내려가 실제로 명령어 창에 'Hello, World'를 띄우기 위해 컴퓨터 메모리를 직접 건드려야 한다. 메모리 영역부터 내려가 H부터 느낌표까지 문자열 하나하나 문자열 구조체를 만들어 담고, 이를 출력하도록 운영체제에 명령을 보내야 한다. 운영체제마다 그것을 표시하는 방식이 다른 것은 물론이다. 하지만 API가 있기 때문에 이미 프로그래밍 언어에 정의된 'printf'를 사용하기만 하면 편리하게 텍스트를 출력할 수 있다. 즉, 잘 설계된 '프로그래밍 인터페이스'를 사용하면 환경(플랫폼)이 달라져도 동일한 코드가 동일한 결과를 수행하며, 보다 편리하게 프로그래밍을 할 수 있다. 이것이 바로 API의 존재 목적이다.

    프로그래밍 언어 혹은 운영체제마다 기본으로 제공되는 API 말고도 기업들이 운영중인 여러 API들이 많다. 전자의 요소들이 '프로그램과 운영체제 간의 상호 작용'을 위한 프로토콜이라면, 기업에서 제공하는 API들은 대개의 경우 '기업의 서버와 개발자 본인의 프로그램 간의 상호 작용'을 위한 프로토콜을 의미하는 경우가 많다. 단, 웹에서 데이터를 전송하기 위한 목적으로 사용되는 'REST API'와는 다르며, 일반인은 물론이고 현직 개발자들도 서로 종종 혼동한다.

    기업들이 API를 운용하는 이유는 다음과 같다. 복잡한 프로그램일수록 개발자가 개발하는 프로그램은 그 프로그램 단독으로 돌아가는 경우가 많지 않으며 이미 개발되어있는 무수한 여러 애플리케이션들과 소통하는 경우가 태반이다. 하지만 소통한답시고 기업들이 애플리케이션의 기반 코드와 자체 보유 데이터에 누구나 접근할 수 있도록 열어버리면 난리가 날 것이다. 따라서 각 기업들은 개발자가 개발한 프로그램의 코드를 작동함에 있어 자체 애플리케이션과 실시간으로 상호작용할 내용이 있다면 이를 위해 '소통 창구'라 할 수 있는 자체 API를 만들어 배포하는 것이다.

    예를 들어, 자신이 개발자이고 이용자가 휴대폰으로 촬영한 영상을 유튜브에 업로드하고 카카오 지도에 촬영한 지도에 촬영한 장소를 기록할 수 있는 앱을 만든다고 가정해보자. 이를 구현하기 위해선 이용자의 구글 계정과 비밀번호를 받아서 유튜브에 업로드할 수 있는 기능을 만들어야 할 것이고 카카오 지도와도 상호 작용이 필요할 것이다. 하지만 유튜브나 구글 서버 DB에 일반 개발자가 직접 접근할 수는 없다. 그렇다고 구글 입장에서는 이러한 서드 파티 앱과 상호 작용을 원천 봉쇄하는 것도 애매하므로 무차별적인 접근을 막고 '적절한 상호 작용'을 위해 자체 개발 API를 배포하는 것이다.

    따라서 개발자는 배포된 API를 받고 이를 자신의 코드에 추가함으로써 원하는 기능을 구현할 수 있다. 말하자면 운용 중인 애플리케이션에 적법한 절차를 걸쳐 허락을 맡고 구현물을 받아오거나 새로운 요소를 삽입, 수정할 수 있는 것이다.

    따라서 구글, 네이버, 카카오 등 많은 IT 회사들이 사내 제품군들의 API를 제공하여 개발 편의를 돕고 자사 제품을 쓰도록 유도하고 있다. 예를 들어 구글 유튜브 Data API를 보면 각 프로그래밍 언어 별로 친절하게 동영상 업로드나 업데이터, 키워드별 검색, 재생목록 만들기 등의 기능을 제공한다. 또 다른 예시로 카카오 지도 API를 통해 개발자는 카카오가 제공하는 함수를 써서 특정 경로를 찍거나, 해당 주변의 지도를 개발물에 띄울 수 있고 이를 개발에 활용할 수 있다. 

    또한 온라인에서 기사를 공유할 때마다 Twitter, Gmail, Facebook 같은 미디어를 통해 링크를 공유할 수 있는 아이콘을 클릭하게 된다. 이러한 모든 서비스는 API에 의해 활성화된다.

    거시적인 예로, 백악관은 재정, 의료, 농업에 이르기까지 대중들에게 정부에 대한 정보에 접근할 수 있는 수천 개의 API를 공개했다. 대중은 투표소, 식품 안전에 대한 정보 또는 기타 유익한 정보를 찾을 수 있으므로 귀중한 시간을 절약했다.

 

API를 사용하는 이유

○ 고객을 위한 향상된 기능 : 기업은 완전히 새로운 데이터 세트와 기능에 액세스 할 수 있기 때문에 고객에게 향상된 고객 경험을 제공할 수 있다. 예를 들어, 웹사이트에 Google 맵을 삽입 하면 사용자가 다른 웹사이트나 애플리케이션을 클릭하지 않아도 되므로 시간이 절약되고 반복 고객이 될 가능성이 높아진다.

 

○ 비용 절감 : 기업은 맞춤형 소프트웨어를 만들기 위해 값비싼 개발자를 고용하는 대신 API를 사용하여 앱과 프로그램 전반을 원활하게 통합할 수 있다. 회사는 자체로 개발하는 대신 기존 소프트웨어를 활용하여 연구 개발 비용을 절약할 수 있다.

 

○ 시간 절약 : API는 일반적으로 이미 작성되었으며 각 엔드와의 통합만 필요하므로 소프트웨어 개발에는 지연이 없다.

 

○ 더 나은 커뮤니케이션 : 비즈니스에 새로운 소프트웨어가 추가되면 API가 모든 것을 통합하여 정보 흐름이 원활하게 이루어진다.

 

○ 원활한 연결 : 이제 거의 모든 스마트 기기 또는 애플리케이션이 인터넷에 연결된다. 냉장고에서 프린터에 이르기까지 현대 기술은 이제 상품으로 이루어진 망이다. API를 사용하면 이러한 스마트 장치를 연결하여 쉽게 인쇄하거나 직장에서 커피를 주문할 수 있다.

 

○ 마케팅 범위 확장 : Facebook, Twitter, Instagram, Pinterest 및 기타 소셜 미디어 플랫폼의 API를 사용하면 버튼 클릭으로 블로그, 정보 또는 제안을 쉽게 공유할 수 있다.

 

○ 운영 간소화 : 예를 들어 비즈니스에서 여행 앱을 개발하는 경우 API를 사용하면 고객이 인터페이스를 벗어나거나 다른 곳에 로그인하지 않고도 비행기에서 차량 공유, 호텔로 이동할 수 있다. API를 사용하여 기업은 예약, 결제 및 이행 구성 요소를 함께 연결할 수 있다.

 

○ 더 빠른 혁신 : 변화 장벽이 더 작아져 더 빠르게 혁신한다. 기성 API는 개발자 시간이 단축되고 결과가 빨라진다. 개발자는 새로운 소프트웨어나 프로그램에 빠르고 쉽게 적응할 수 있다.

 

    많은 API는 무료로 소프트웨어를 제공하는 회사 또는 개발자와 함께 제공된다. 이는 일반적으로 프로그램을 사용하면 소프트웨어의 범위와 시장 진출이 확대되어 더 많은 사용자가 생성되기 때문이다. 

 

API 작동 방식

○ SOAP API

 - 이 API는 단순 객체 접근 프로토콜을 사용한다. 클라이언트와 서버는 XML을 사용하여 메시지를 교환한다. 과거에 더 많이 사용되었으며 유연성이 떨어지는 API이다.

○ RPC API

 - 이 API를 원격 프로시처 호출이라고 한다. 클라이언트가 서버에서 함수나 프로시저를 완료하면 서버가 출력을 클라이언트로 다시 전송한다.

○ WebSocket API

 - 이 API는 JSON 객체를 사용하여 데이터를 전달하는 또 다른 최신 웹 API 개발이다. WebSocket API는 클라이언트 앱과 서버 간의 양방향 통신을 지원한다. 서버가 연결된 클라이언트에 콜백 메시지를 전송할 수 있어 REST API보다 효율적이다.

○ REST API

 - 오늘날 웹에서 가장 많이 볼 수 있는 가장 많이 사용되고 유연한 API이다. 클라이언트가 서버에 요청을 데이터로 전송한다. 서버가 클라이언트 입력을 사용하여 내부 함수를 시작하고 출력 데이터를 다시 클라이언트에 반환한다.

 

* SOAP와 REST의 차이

    웹 API가 확산됨에 따라, 정보 교환을 표준화하기 위해 SOAP(Simple Object Access Protocol)라는 프로토콜 사양이 개발되었다. SOAP로 설계된 API는 XML 메시지 형식을 사용하며 HTTP 또는 SMTP를 통해 요청을 수신한다. SOAP를 사용하면 더 간편한 방법으로 애플리케이션을 다양한 환경에서 실행하거나 다양한 언어로 작성하여 정보를 공유할 수 있다.

    또 다른 사양한 REST(Representational State Transfer)로, REST 아키텍처의 제약 조건을 준수하는 웹 API를 RESTful API라고 합니다. SOAP는 프로토콜이지만 REST는 아키텍처 스타일이라는 근본적인 차이가 있으며 따라서 RESTful 웹 API에는 공식적인 표준이 없다. SOAP의 규정된 프로토콜에 비해 훨씬 간단해서 RESTful API가 SOAP보다 더 많이 사용되고 있다.

    현재 부상하는 또 다른 API 표준은 쿼리 언어이자 서버 측 런타임으로 REST의 대안인 GraphQL이다. GraphQL은 클라이언트에게 요청한 만큼의 데이터를 제공하는 데 우선순위를 둔다. REST를 대체할 수 있는 GraphQL은 개발자가 단일 API 호출로 다양한 데이터 소스에서 데이터를 끌어오는 요청을 구성할 수 있도록 지원한다.

 

웹 API란?

    웹 API는 웹 서버와 웹 브라우저 간의 애플리케이션 처리 인터페이스이다. 모든 웹 서비스는 API이지만 모든 API가 웹 서비스는 아니다. REST API는 위에서 설명한 표준 아키텍처 스타일을 사용하는 특수한 유형의 웹 API이다.

    역사적으로 API가 월드 와이드 웹 전에 만들어졌기 때문에 Java API, 서비스 API 등 API에 대한 다양한 용어가 존재한다. 최신 웹 API는 REST API이며 용어는 서로 바꿔 사용할 수 있다.

 

원격 API란?

    원격 API는 커뮤니케이션 네트워크를 통해 상호 작용하도록 설계되었다. 여기서 원격이란 API에 의해 조작되는 리소스가 요청을 보내는 컴퓨터의 외부에 있음을 의미한다. 가장 광범위하게 사용되는 커뮤니케이션 네트워크가 인터넷이기 때문에 대부분의 API는 웹 표준을 기반으로 설계되며, 모든 원격 API가 웹 API인 것은 아니지만 웹 API가 원격이라고 가정할 수는 있다.

    웹 API는 일반적으로 요청 메시지에 HTTP를 사용하여 응답 메시지 구조의 정의를 제공한다. 이러한 응답 메시지는 일반적으로 XML 또는 JSON 파일의 형태이다. 다른 애플리케이션이 쉽게 조작할 수 있는 방식으로 데이터를 표시하므로 XML과 JSON 둘 다 자주 사용된다.

 

API 통합이란?

    API 통합은 클라이언트와 서버 간의 데이터를 자동으로 업데이트하는 소프트웨어 구성 요소이다. API 통합의 몇 가지 예로 휴대폰 이미지 갤러리에서 클라우드로 데이터 자동 동기화 또는 다른 시간대 여행 시 노트북에서 시간 및 날짜 자동 동기화가 있다. 기업은 또한 API 통합을 사용하여 많은 시스템 함수를 효율적으로 자동화할 수 있다.

 

API의 사용 범위

○ 프라이빗 API

 - 기업 내부에 있으며 비즈니스 시스템과 데이터를 연결하는 데만 사용

○ 퍼블릭 API

 - 일반에 공개되며 누구나 사용할 수 있다. 이러한 유형의 API와 관련된 권한 부여와 비용이 있을 수도, 없을 수도 있다.

○ 파트너 API

 - B2B 파트너십을 지원하기 위해 권한이 부여된 외부 개발자만 액세스

○ 복합 API

 - 두 개 이상의 서로 다른 API를 결합하여 복잡한 시스템 요구 사항이나 동작을 처리

 

API 생성 방법

1. API 계획

 - OpenAPI와 같은 API 사양은 API 설계를 위한 블루프린트를 제공한다. 다양한 사용 사례를 미리 생각하고 API가 현재 API 개발 표준을 준수하는지 확인하는 것이 좋다.

2. API 빌드

 - API 디자이너는 상용 코드를 사용하여 API 프로토타입을 생성한다. 프로토타입이 테스트되면 개발자는 내부 사양에 맞게 이를 사용자 지정할 수 있다.

3. API 테스트

 - API 테스트는 소프트웨어 테스트와 동일하며 버그 및 결함을 방지하기 위해 수행되어야 한다. API 테스트 도구로 사이버 공격에 대비하여 API를 강화할 수 있다.

4. API 문서화

 - API는 그 자체로 설명이 필요 없지만 API 문서는 사용 편의성은 높이는 가이드 역할을 한다. 다양한 기능과 사용 사례를 제공하는 잘 문서화된 API는 서비스 지향 아키텍처에서 더 많이 사용되는 경향이 있다.

5. API 마케팅

 - API 마켓플레이스는 개발자가 다른 API를 사고 팔기 위해 존재한다. API를 나열하여 수익을 창출할 수 있다.

 

API 테스트

 - API 테스트 전략은 다른 소프트웨어 테스트 방법론과 유사하다. 서버 응답 검증에 주로 초점을 둔다. API 테스트에는 다음이 포함된다.

○ 성능 테스트를 위한 다량의 API 엔드포인트 요청

○ 비즈니스 로직 및 기능적 정확성을 확인하기 위한 단위 테스트 작성

○ 시스템 공격을 시뮬레이션하여 보안 테스트

 

API 문서 작성법

 - 포괄적인 API 문서 작성은 API 관리 프로세스의 일부이다. API 문서는 도구를 사용하여 자동 생성하거나 수동으로 작성할 수 있다. 몇 가지 모범 사례는 다음과 같다.

○ 간단하고 읽기 쉬운 영어로 설명을 작성. 도구로 생성된 문서는 장황하며 편집이 필요할 수 있다.

○ 코드 샘플을 사용하여 기능을 설명

○ 문서를 정확하고 최신 상태를 유지

○ 초심자를 위한 작문 스타일

○ API가 사용자를 위해 해결할 수 있는 모든 문제를 다룬다.

 

API 사용법

1. API 키를 받는다. API 공급 업체의 확인을 받은 계정을 생성

2. HTTP API 클라이언트를 설정. 이 도구를 사용하면 수신된 API 키를 사용하여 API 요청을 쉽게 구성

3. API 클라이언트가 없는 경우 API 설명서를 참조하여 브라우저에서 요청을 직접 구성할 수 있다.

4. 새 API 구문에 익숙해지면 코드에서 이를 사용

 

API 마켓플레이스

 - 새로운 웹 API는 API 마켓플레이스 및 API 디렉터리에서 찾을 수 있다. API 마켓플레이스는 누구나 판매용 API를 나열할 수 있는 개방형 플랫폼이다. API 디렉터리는 디렉터리 소유자가 규제하는 제어된 리포지토리이다. 전문 API 디자이너는 새 API를 디렉터리에 추가하기 전에 평가하고 테스트할 수 있다.

○ RapidAPI - 10,000여 개의 Public API와 현장에서 활동 중인 1백만 명의 개발자를 만날 수 있는 최대 규모의 글로벌 API 시장. RapidAPI를 통해 사용자는 구매를 결정하기 전에 플랫폼에서 직접 API를 테스트 할 수 있다.

○ Public APIs - 이 플랫폼은 요구 사항에 맞는 API를 쉽게 탐색하고 찾을 수 있도록 원격 API를 40개의 틈새 범주로 그룹화한다.

○ APIForThat 및 APIList - 이 두 웹 사이트에는 사용 방법에 대한 심층 정보와 함께 500여 개의 웹 API 목록이 있다.

 

API 게이트웨이

    API 게이트웨이는 광범위한 백엔드 서비스를 사용하는 기업 클라이언트를 위한 API 관리 도구이다. API 게이트웨이는 일반적으로 모든 API 호출에 적용할 수 있는 사용자 인증, 통계 및 속도 관리와 같은 일반적인 태스크를 처리한다.

 

 

참고자료 : https://aws.amazon.com/ko/what-is/api/

API란 무엇인가요? - API 초보자를 위한 가이드 - AWS

참고자료 : https://ko.wikipedia.org/wiki/API

API - 위키백과, 우리 모두의 백과사전

참고자료 : https://namu.wiki/w/API

API - 나무위키

참고자료 : https://www.tibco.com/ko/reference-center/what-is-an-api-application-program-interface

API(애플리케이션 프로그램 인터페이스)란 무엇입니까?

참고자료 : https://www.redhat.com/ko/topics/api/what-are-application-programming-interfaces

API(애플리케이션 프로그래밍 인터페이스)란 - 개념, 기능, 장점