RSS

태그 보관물: apigee

REST API설계에 도움이 되는 링크 모음

최근 LBSNS 아임IN 시즌2 개발하면서, Restful API를 설계하면서 다른 곳에서는 어떻게 하고 있는지 찾아보고, 비평하며, 배우고 있습니다.

제 경우는 Rails를 익히고 있던 터라, 사실 대부분의 Resource 설계에 대한 지식은 Rails route 쪽 문서를 통해서 익혔습니다.

Rails Routing from the Outside In

이 문서는 Rails에 대한 기본적인 컨셉을 알고 있는 분들에게 유용할 것입니다만, 그렇지 않더라도 Resource에 대한 실제적인 설명을 보고 싶은 분들에게 추천하고 싶습니다.

저는 “Restful api라면 Rails처럼” 이라고 줄여서 표현하고 싶을 정도입니다.

REST관련 서적이 Ruby로 구현된 점도, Rails개발자들이 REST API에 영향을 주고 받고 있다는 증거인지 모르겠습니다.

Apigee라는 회사에서 설계 관련 문서를 자주 무료 ebook형식으로 내놓고 있습니다. 이들의 이야기도 볼 만합니다. API 컨설팅을 해주면서 익혔던 교훈을 가볍게 소개하고 있습니다. 분량도 적어 빨리 볼 수 있습니다.

이 중에서 두 문서를 추천합니다. (다운 받으려면 간단한 폼을 작성해야 하더군요)

  • Is Your API Naked? – API 로드맵이라는 부제에 걸맞게 API관련 일반적인 토픽을 다루고 있습니다.
  • Web API Design – API설계할 때 구체적으로 필요한 내용들을 다룹니다. (한글 의역)
Apigee의 동영상도 하나 링크합니다. 무려 1년이나 된 동영상이지만, REST API에 대한 통찰을 전해줍니다. 즐감하세요~!
Atlassian에서 자신들의 앱에 REST API를 추가할 때, 가이드 라인을 제시하고 있습니다.
Atlassian REST API Design Guide Part 1 (누가 아틀라시안 아니랄까봐, 아주 복잡한 이야기 그대로 쓰고 있습니다 ^^)
유명 서비스들 REST API 페이지
이건 재미로, “내 아내에게 REST를 설명했던 방법“이란 블로그 포스트 한국어로 번역되지 않았는데, 심심할 때 한번 번역해보면 좋을듯. 🙂
apigee의 webinar인데 시간이 많으신 분들은 한 번 들어보세요.
미물님의 좋은 API 설계란 무엇인지 다루는 포스트 “Web API Design: 개발자에게 사랑받는 API만들기”
더 유용한 글이 보이면 이 페이지에 더 추가해 놓겠습니다. 추천해주세요~! 🙂
(to be update… )
 
댓글 9개

게시자: 켬 2012년 5월 8일 in API Design, OpenAPI

 

태그: , , , ,