쏘댕

REST API 디자인 가이드 [출처] http://bcho.tistory.com/954 REST API 디자인을 보면, REST 사상에 맞춰서 제대로 디자인 (CRUD를 HTTP method에 맞춘)하기도 어렵고,URI Convention등이나 보안, 버전 관리등 고려할 사항이 많다.이번 글에서는 REST API를 디자인에 대한 가이드를 소개하고자 한다. 동사보다는 명사를 사용하자. URL을 심플하고 직관적으로 만들자. REST API를 URL만 보고도, 직관적으로 이해할 수 있어야 한다.URL을 길게 만드는것 보다, 최대 2 depth 정도로 간단하게 만드는 것이 이해하기 편하다. /dogs/dogs/1234 URL에 동사보다는 명사를 사용하고,REST API는 리소스에 대해서 행동을 정의하는 형태를..

[출처] http://www.mimul.com/pebble/default/2012/08/07/1344315512542.html 기업 및 개발자들에게 API 제품 및 기술을 공급하는 Apigee는 Web API 설계에 관한 무료 책 "Web API Design : Crafting Interfaces that Developers Love"를 발표했다. 여기에는 좋은 API를 설계하기 위한 Best practices가 정리되어 있어, API를 도입하는 분들에게는 좋은 노하우를 제공하고 있어, 본 포스트에서는 "Web API Design"이라는 책을 참고하여 좋은 API 설계란 무엇인지에 대해서 정리해 본다. 1. 기본 URL에는 동사가 아닌 명사를 사용하며, 리소스마다 2개의 기본 URL을 유지하자. - 심플..