오픈 API

오픈 API(Open API)는 개발자라면 누구나 사용할 수 있도록 공개된 API를 말한다. 오픈 API는 "Open Application Programming Interface"의 약자로서, 공개 API라고도 한다. 구글 지도나 네이버 지도 서비스를 위한 데이터를 제공해 주는 오픈 API 등이 있다. 반대말은 프라이빗 API(Private API)이다.

개요

API 중에서 플랫폼의 기능 또는 콘텐츠를 외부에서 웹 프로토콜(HTTP)로 호출해 사용할 수 있게 개방한 API를 의미한다. 네이버 개발자센터에서 제공하고 있는 지도, 검색을 비롯한 기계 번역, 캡처, 단축 URL 등 대부분 API는 HTTP로 호출할 수 있는 오픈 API에 해당한다.

API는 어떠한 응용 프로그램에서 데이터를 주고 받기 위한 방법을 의미한다. 오픈 API와 비공개 API로 나누어지며 특정 사이트에서 특정 데이터를 공유할 경우 어떠한 방식으로 정보를 요청하고 받을 수 있는지에 대한 규격들을 API라고 부른다. 오픈 API를 사용하면 개발시 들어가는 시간을 줄이고 비용을 절감할 수 있으며 더욱 양질의 앱을 개발할 수 있다. API를 제공하는 이유는 API를 통해 정보 및 기능을 제공함으로써 더 많은 이익을 얻을 수 있기 때문인데 이 둘의 공생관계를 로그인 정보제공 API를 통한 예로 들어본다면 개발자의 경우 사용자로 하여금 회원가입이라는 귀찮은 절차없이 앱을 사용할 수 있게 유도할 수 있고, 제공처의 경우 홍보효과와 함께 로그인 정보가 제공처의 아이디로 가입이 되어 연동되어 있기 때문에 함부로 회원탈퇴를 하지 못한다는 점을 이용하여 이탈율을 줄일 수 있다.

특징

사용 목적

API를 어떤 목적으로 사용하는가에 따라 다음과 같이 나눌 수 있으며, 오픈 플랫폼에서는 대외적으로 오픈 API(Open API), 파트너 API(Partner API), 컴포시트 API(Composite API)를, 내부 시스템에서는 인터널 API(Internal API), 컴포시트 API(Composite API)를 주로 활용한다.

• 오픈 API

혹은 퍼블릭 API(Public API), 외부에서 제약없이 호출할 수 있도록 공개된 API. 오픈 플랫폼에서 기본적으로 제공되어야 할 API 형태이다.

• 파트너 API

혹은 제휴 API, 핀테크기업 등 제휴업체와 사전 협의 후 제작하여 제공하며 이용 라이선스, 권한 등이 별도로 필요하다.

• 인터널 API

혹은 프리베이트 API(Private API), 기업 내부 시스템에서만 사용될 수 있으며, ESB 시스템이나 내부용 API 게이트웨이에 등록되어 호출되거나, API 서버에 직접 등록되어 클라이언트에서 호출될 수도 있다.

• 컴포시트 API

복수의 API를 한번에 동기적으로 호출하는 방식으로 처리 속도를 높일 수 있으며, 개별 API 의 성공, 실패를 하나의 응답에 복합 하위 요청으로 구별하여 되돌려준다.

분류

Open API의 의미는 인터넷 이용자가 일방적으로 웹 검색 결과 및 사용자인터페이스(UI) 등을 제공받는 데 그치지 않고 직접 응용 프로그램과 서비스를 개발할 수 있도록 공개된 API를 말한다. 지도 서비스 및 다양한 서비스에서 시도되고 있으며 누구나 접근하여 사용할 수 있다는 장점이 있다.

• 매쉬업

매쉬업(Mash up)이란 웹서비스 업체들이 제공하는 각종 콘텐츠와 서비스를 융합하여 새로운 웹서비스를 만들어내는 것을 의미하는 말이다. 구글이 공개한 검색 관련 응용 프로그램 인터페이스(API)와 지도 관련 API, 그리고 기타 여러 웹 서비스 정보들을 혼합하여 부동산 매매에 응용한 것처럼 다수의 정보원으로부터 제공되는 콘텐츠를 조합하여 하나의 서비스로 제공하는 웹 사이트 또는 애플리케이션을 가리킨다.

• 플랫폼으로서의 웹

활용

Oepn API는 다양한 방식으로 활용권한을 부여하지만 가장 기본적이고 대중적으로 허가받은 유저에게 service키를 발급한다. 따라서 open api를 확용하기 위해선 보통 신청을 하고 키를 발급받는다. 키를 사용하는데 있어서도 대부분 소프(SOAP), 레스트(REST) 유형을 사용한다.

• 소프

소프(SOAP)는 HTTP, HTTPS, SMTP 등을 통해 XML 기반의 메시지를 컴퓨터 네트워크 상에서 교환하는 프로토콜이다. XML로 만들어진 웹서비스의 데이터를, WSDL라는 이름의 웹표준형태로 정의하여 UDDI라는 일종의 전역적 저장소에 등록하여 이용가능도록 만든 것이다. 소프를 통해 교환데는 XML 데이터는 소프 인벨롭(SOAP Envelope), 소프 헤더(SOAP Header), 소프 바디(SOAP Body)로 구성된다.

장점

분산 컴퓨팅환경을 다루기 위해 설계되어 있고, 다양한 표준규약에 익숙한 경우 많은 확장을 할 수 있다.

단점

복잡한 구조를 가지고 있어서 HTTP상에서 바로 전달되기 무겁고, 인코딩/디코딩 과정등 처리(혹은 개발)하는데에 난이도가 높다. 또한, 사용을 위해 별도의 개발환경(Tool)이 필요하다.

• 레스트

레스트(REST)는 HTTP 프로토콜로 데이터를 전달하는 프레임워크이다. 단순한 HTTP 요청과 그 결과를 단순한 XML등의 포맷으로 돌려주는 구조이다. UDDI를 통해 등록하고, 탐색하는 등의 과정을 거치는 SOAP기반 서비스와 다르게, REST는 중간 매개체 없이 리소스제공자가 직접 리소스 요청자에게 제공을 할 수 있어, 간단하다. REST원리를 따르는 시스템을 종종 RESTful이라는 용어로 지칭한다.

장점

소프보다 처리(및 개발)가 쉽다.

단점

소프와 반대로 표준규격이 부족하여 함축적이지 않고 안정성이 덜하다.

API를 처음 접하는 사용자 입장에서, 소프는 다루기 어렵다. 그렇기 때문에 최근엔 REST를 주로 사용한다. 따라서 API의 사용법 역시 REST에 기반한 API제공에 초점을 둔다.

레스트는 분산 하이퍼미디어 시스템을 위한 아키텍처 스타일이고 레스트 API(REST API)는 레스트 아키텍처 스타일을 따르는 API 이며, 일부 아키텍처 제약을 따르는 것을 RESTful API 라고 한다. 레스트 창시자인 Roy Fielding 은 "하이퍼텍스트를 포함한 메시지의 유니폼 인터페이스(uniform interface)를 통해 리소스에 접근하는 API" 라고 정의하였다.

유니폼 인터페이스 제약조건 4가지

• 자원 확인
• 표현을 통한 자원 조작
• 자체 확인 메시지
• 하이퍼미디어의 애플리케이션 상태

같이 보기

• API
• 프라이빗 API

이 오픈 API 문서는 프로그래밍에 관한 토막글입니다. 위키 문서는 누구든지 자유롭게 편집할 수 있습니다. [편집]을 눌러 이 문서의 내용을 채워주세요.

개발 : 프로그래밍 □■⊕, 소프트웨어, 데이터, 솔루션, 보안, 하드웨어, 컴퓨터, 사무자동화, 인터넷, 모바일, 사물인터넷, 게임, 메타버스, 디자인 프로그래밍 언어 ASP • C 언어 • C++ • C# • CSS • D 언어 • HTML • HTML5 • JSP • PHP • R • XHTML • XML • XSLT • 고(Go) • 고급언어 • 기계어 • 델파이 • 러스트 • 루비 • 루아 • 리액트 • 리퀴디티 • 무브 • 미켈슨 • 베이직 • 브이비스크립트 • 비주얼 C++ • 비주얼베이직(VB) • 비주얼베이직닷넷(VB.NET) • 솔리디티 • 스몰토크 • 스위프트 언어 • 스칼라 • 스크립트 언어 • 알골 • 어셈블리 • 언리얼스크립트 • 얼랭 • 에이잭스(Ajax) • 엠에프씨(MFC) • 오브젝티브-C • 오브젝트 파스칼 • 오카멜 • 웹어셈블리(WASM) • 이와즘(eWASM) • 자바 • 자바스크립트 • 저급언어 • 제이슨(JSON) • 제이쿼리(jQuery) • 카멜 • 코볼 • 코틀린 • 콜드퓨전 • 타입스크립트 • 파스칼 • 파워스크립트 • 파이썬 • 펄(Perl) • 포트란 • 프로씨(Pro-C) • 피엘에스큐엘(PL/SQL) • 피엘원(PL/I) • 하스켈 개발방법론 CBD 개발방법론 • EA • 구조적 개발방법론 • 객체지향 개발방법론 • 라이브러리 • 람다 아키텍처 • 모듈 • 모듈화 • 벤치마킹 • 소프트웨어 개발방법론 • 스크럼 • 스프린트 • 아키텍처 • 아키텍트 • 애자일 • 웹개발방법론 • 정보공학 개발방법론 • 컴포넌트 • 테일러링 • 템플릿 • 폭포수 모델 • 프로젝트 • 프로토타입 • 피드백 코딩 EUC-KR • UTF-8 • 값 • 글루웨어 • 디버깅 • 디코딩 • 마크업 • 버그 • 부트스트랩 • 세이브포인트 • 소스코드 • 시큐어코딩 • 아스키 • 액티브엑스 • 오픈소스 • 유니코드 • 인코딩 • 재컴파일 • 주석 • 컴파일 • 컴퓨터 프로그램 • 코드 • 코딩 • 태그 • 테스트 • 테이블 • 텍스트 • 파싱 • 퍼블리싱 • 퓨니코드 • 하드코딩 • 하이퍼링크 • 하이퍼텍스트 프로그래밍 C 명령어 • 객체 • 객체지향 • 객체지향 프로그래밍 • 거짓 • 관계연산자 • 기본형 변수 • 널 • 논리 • 논리연산 • 논리연산자 • 다중상속 • 다형성 • 대입 • 대입문 • 대입연산자 • 더블 • 도스 명령어 • 디폴트 • 레지스터변수 • 루프 • 리눅스 명령어 • 리턴 • 메모리 주소 • 메소드 • 멤버 • 명령문 • 명령어 • 무한루프 • 문자 • 문자열 • 바이트 • 반복문 • 배열 • 변수 • 분기 • 분기문 • 불린 • 브레이크 • 비교연산자 • 비트연산자 • 산술연산자 • 상속 • 상수 • 생성자 • 선언 • 선언문 • 설정자 • 속성 • 스위치 • 스태틱 • 시프트연산자 • 실행 • 실행문 • 어노테이션 • 에코 • 역참조 • 연산 • 연산문 • 연산자 • 오버로딩 • 오버라이딩 • 외부변수 • 윈도우 명령어 • 유닉스 명령어 • 인스턴스 • 인스트럭션 • 인클루드 • 인터페이스 • 임포트 • 입력 • 입력문 • 입출력 • 입출력문 • 자료형(데이터 타입) • 자바 명령어 • 자바 예약어 • 자바 컬렉션 • 전역변수 • 접근자 • 접근제어자 • 정보은닉 • 정수형 • 정적변수 • 제어 • 제어문 • 제어자 • 조건 • 조건문 • 조건연산자 • 주소 • 증감연산자 • 지역변수 • 참 • 참조 • 참조변수 • 초기화 • 추상메소드 • 추상클래스 • 추상화 • 출력 • 출력문 • 캡슐화 • 케이스 • 클래스 • 파라미터(매개변수) • 파이널 • 패키지 • 퍼블릭 • 포인터 • 프라이빗 • 프로텍티드 • 필드(멤버변수) • 함수 • 환경변수 명령어 abstract • array • boolean • break • byte • case • char • continue • default • double • do while • echo • elif • else • else if • false • final • float • for • gosub • goto • if • if else • import • include • int • join • long • long long • null • print • printf • println • private • protected • public • return • scanf • short • stdio.h • static • string • switch • temp • then • true • unsigned • void • while 디자인패턴 구조패턴 • 동시성패턴 • 동시실행패턴 • 모델-뷰-컨트롤러 패턴 • 상태패턴 • 생성패턴 • 싱글톤패턴 • 아키텍처패턴 • 전략패턴 • 커맨드패턴 • 행동패턴 프로그래밍 인물 귀도 반 로썸 • 그레이스 머레이 호퍼 • 니클라우스 비르트 • 댄 브릭클린 • 더그 커팅 • 데니스 리치 • 리누스 토르발스 • 리처드 그린블라트 • 마거릿 해밀턴 • 마크 앤드리슨 • 빈트 서프 • 빌 게이츠 • 빌 조이 • 스티브 잡스 • 에이다 러브레이스 • 제임스 고슬링 • 척 벤턴 • 켄 톰슨 • 팀 패터슨 위키 : 자동차, 교통, 지역, 산업, 기업, 단체, 업무, 쇼핑, 블록체인, 암호화폐, 인공지능, 개발, 인물, 행사, 일반