윤 석 찬

@channyun

JVM Platform Web site

Java API Interface Open API

Java Application

Software Data

Developer Participators User, Small Biz.

API Lock-in Key Factor Data Lock-in

OS WebSocialMobile

Internet

Dot‐Com Bubble

Web 2.0 Social Graph

Cloud

Open WebGoogle, Amazon, Ebay

Socialfacebook, Twitter

CloudAWS, Hadoop

Social Graph

MobileiOS, Android

ClosedWindows, Java

Program

Open SourceGNU, Linux, Apache

폐쇄된 API를 가진버추얼 머신 Platform

개방된 API를 가진웹 서비스

독자적/폐쇄형 API 개방형/표준형

학습 비용 등진입이 어려움

Costs 빠르고 쉽게 개발 및서비스 가능

기능 위주 Lock-in 데이터 위주

각 플랫폼 기반개발자

Developers웹 서비스 기반

개발자

.NetJava

ExamplesGoogleAmazon

Agenda

오픈 API란?오픈 API 성공 사례오픈 API 구현 방법오픈 API 홍보 및 개발자 지원Daum 오픈 API

•7

Open API?Open API is a word used to describe sets of technologies that enable

websites to interact with each other by using REST, SOAP, JavaScript and other web technologies. While its

possibilities aren't limited to web-based applications, it's becoming an increasing trend in so-called Web 2.0 applications. The term API stands for Application Programming Interface.

http://en.wikipedia.org/wiki/Open_API

http://api.twitter.com/1/statuses/show/99.json

Request

How to?

Parse

"created_at": "Wed Mar 22 03:38:41 +0000 2006","id": 99,"id_str": "99",

"text": "learning about the earthquake I felt earlier today",

"source": "web","user": {"id": 13,"name": "Biz Stone","screen_name": "biz","location": "San Francisco, CA","description": "Co‐founder of Twitter, Inc.","url": "http://t.co/bdlNWgB"}

}

Use

왜 오픈 API를? 창업자 관점

다양한 비즈니스 개발 타진– 자원이 부족한 스타트업의 경우, 서드파티 및 파트너와

의 협업을 위해 가능성 탐지

서비스 주변 개발자 생태계 확보– 외부 개발자들이 언제든지 API를 통해 매쉬업 개발, 버

그 리포팅, 아이디어 제공

투자자에게 플랫폼으로 어필– 작지만 죽지 않을(?) 파트너쉽 및 개발자 생태계 구성

은 투자할 이유가 됨!

API 증가 속도

© ProgrammableWeb.com

API 사용 현황

API 1billion Club

© ProgrammableWeb.com

스타트업 성공 사례

• 서비스 시작부터 API 제공

• 200여개의 미투앱스

• 20여개의 소셜플러그인 제휴

• 월 2억건의 쿼리 (2011.4)

• iOS에서만 앱 제공

• 1초에 15장, 하루 130 만장 등록

• 2,500여개의 외부앱

• 250여개의 github 레포지터리

Fred Wilson’s 10 Golden Principles of Successful Web Apps

5. Make it Programmable

http://thinkvitamin.com/web‐apps/fred‐wilsons‐10‐golden‐principles‐of‐successful‐web‐apps/

왜 오픈 API를? 개발자 관점

프로그래밍은 결국 API 디자인– 좋은 코드는 Module화 되어 있고, 각 모듈은 API로 구

성되어 있다.

좋은 API는 높은 재사용성 제공– API 사용자가 생기면 변경하기가 어려우며, 처음 부터

설계에 노력을 들이게 된다.

외부 개발자와의 협업이 가능– 스타트업에서 개발자는 외롭다. 하지만 API를 오픈하

면 밖에도 내 편을 만들 수 있다.

어떻게 만들어야 하나?

직관적이고 배우기 쉽게– 문서 없이도 형식만 보고도 이해할 수 있어야 한다.

설계는 완벽하게– 한번 만든 API는 하위 호환성 때문에 쉽게 바꾸기 어렵다.

보안은 최소화– 너무 많은 제한을 두면 개발자로 부터 반감을 얻을 수 있다.

벤치마크– 좋은 API를 따라한다. Copy & Paste가 답!

API 서비스 프로토콜

프로토콜 종류

REST는 서비스 개발 및 활용 비용 ↓

종류 설명 형식자원인식

자원접근

자원처리

자원링크

사례

WS-* SOA 기반 웹서비스

WSDL을 통한 표현 Google AdsenseAPI

RPC 자원에 파라미터로 접근

GET /service?1 Amazon SimpleDBAPI

API 객체 방법으로 접근

PUT /order/1 Twitter API

REST 하이퍼링크로 접근

<link type=“atom” AtomPublishing Protocol

http://www.nordsc.com/ext/classification_of_http_based_apis.html

API Best Practices

1. 객체 표현POST /photos/create POST /photos/show/foobarPOST /photos/update/foobarPOST /photos/delete/foobar

2. 호환성http://apis.daum.net/maps/v1/jshttp://apis.daum.net/maps/v2/js

3. 에러처리<apierror>

<code>404</code><message>App 인증 실패</message><dcode>22</dcode><dmessage>등록되지 않은 apikey 입니다.</dmessage>

</apierror>

•22

4. 다양한 포맷 (JSON, XML, RSS){ 'person' : 

{ 'name': '...', 'age' : 22, 'dogs' : [...] } }자바스크립트 개발자를 위한 Callback 함수 지원 필수

5. 보안 강화– APIKey와 트래픽 제어가 필수는 아니다!

– 사용자 데이터는 oAuth 이용

– 암호화 제공은 선택 사항

API 개발 프레임웍

웬만한 MVC 프레임웍은 지원!

– RESTful 지원 프레임웍• http://en.wikipedia.org/wiki/Representational_State_Transfer#Fra

mework_implementations

–Django with Pistons• Django-Tastypie https://github.com/toastdriven/django-tastypie

– Ruby on Rails

Node.js

– 이벤트 기반 웹 서비스에 유리

API 서드 파티 지원

★ 오픈 API 퍼블리싱에 도움을 줌!

http://apievangelist.com/serviceproviders/

oAuth란?

Token

6. 문서화– 레퍼런스, 변경기록, 코드샘플 및 코드 놀이터

7. 기술 지원– 오픈소스 개발방법 : 이슈트래커, 포럼, gitHub

8. 개발자 만나기– Hackerton, DevDay, CodeJam, DevConference

•27

개발자 지원 핸드북

•28http://dna.daum.net/ko/developer‐support‐handbook

Github http://github.com

Open Source Developer’s Social Networks

API Playground

에반젤리즘

1.5 billion per year

5000 per day

외부 개발자 만남– 소통과 대화

Daum 개발자네트워크

Daum Developers Network & Affliates‐ http://dna.daum.net

개발자의 마음을 사는 법

Thanks for Attention : Q&A

Seokchan (Channy) Yun

channy@creation.nethttp://channy.creation.net

http://twitter.com/channyun