의견.png

"오픈 API"의 두 판 사이의 차이

해시넷
이동: 둘러보기, 검색
(활용)
33번째 줄: 33번째 줄:
  
 
API를 처음 접하는 사용자 입장에서, 소프는 다루기 어렵다. 그렇기 때문에 최근엔 REST를 주로 사용한다. 따라서 API의 사용법 역시 REST에 기반한 API제공에 초점을 둔다. <ref>코딩cheat sheet, 〈[https://godongyoung.github.io/%EC%BD%94%EB%94%A9cheat%20sheet/2019/05/22/Open-API-%ED%99%9C%EC%9A%A9%EB%B0%A9%EB%B2%95-%EC%A0%95%EB%A6%AC(%EA%B0%84%EB%8B%A8-%EC%84%A4%EB%AA%85).html (cheat sheet)Open API 활용방법 정리(간단 설명)]〉, 《개인 블로그》, 2019-05-22</ref>
 
API를 처음 접하는 사용자 입장에서, 소프는 다루기 어렵다. 그렇기 때문에 최근엔 REST를 주로 사용한다. 따라서 API의 사용법 역시 REST에 기반한 API제공에 초점을 둔다. <ref>코딩cheat sheet, 〈[https://godongyoung.github.io/%EC%BD%94%EB%94%A9cheat%20sheet/2019/05/22/Open-API-%ED%99%9C%EC%9A%A9%EB%B0%A9%EB%B2%95-%EC%A0%95%EB%A6%AC(%EA%B0%84%EB%8B%A8-%EC%84%A4%EB%AA%85).html (cheat sheet)Open API 활용방법 정리(간단 설명)]〉, 《개인 블로그》, 2019-05-22</ref>
 +
 +
레스트는 분산 하이퍼미디어 시스템을 위한 아키텍처 스타일이고 레스트 API(REST API)는 레스트 아키텍처 스타일을 따르는 API 이며, 일부 아키텍처 제약을 따르는 것을 RESTful API 라고 한다. 레스트 창시자인 Roy Fielding 은 "하이퍼텍스트를 포함한 메시지의 유니폼 인터페이스(uniform interface)를 통해 리소스에 접근하는 API" 라고 정의하였다.
 +
 +
; 유니폼 인터페이스 제약조건 4가지
 +
* 자원 확인
 +
* 표현을 통한 자원 조작
 +
* 자체 확인 메시지
 +
* 하이퍼미디어의 애플리케이션 상태
  
 
{{각주}}
 
{{각주}}

2020년 9월 21일 (월) 12:10 판

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

개요

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

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

특징

활용

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제공에 초점을 둔다. [3]

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

유니폼 인터페이스 제약조건 4가지
  • 자원 확인
  • 표현을 통한 자원 조작
  • 자체 확인 메시지
  • 하이퍼미디어의 애플리케이션 상태

각주

  1. API 공통 가이드〉, 《네이버디벨로퍼》
  2. 달나라 곰돌이, 〈(Open API) 오픈 API란?〉, 《티스토리》, 2018-06-28
  3. 코딩cheat sheet, 〈(cheat sheet)Open API 활용방법 정리(간단 설명)〉, 《개인 블로그》, 2019-05-22

같이 보기


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