목록API & Doc (2)
Enterprise APP
REST 아키텍처를 훌륭하게 적용하기 위한 몇 가지 디자인 팁2012년 02월 27일 | 김재석최근의 서비스/애플리케이션의 개발 흐름은 멀티 플랫폼, 멀티 디바이스 시대로 넘어와 있습니다. 단순히 하나의 브라우저만 지원하면 되었던 이전과는 달리, 최근의 서버 프로그램은 여러 웹 브라우저는 물론이며, 아이폰, 안드로이드 애플리케이션과의 통신에 대응해야 합니다. 그렇기 때문에 매번 서버를 새로 만드는 수고를 들이지 않기 위해선 범용적인 사용성을 보장하는 서버 디자인이 필요합니다.REST 아키텍처는 Hypermedia API의 기본을 충실히 이행하여 만들고자 하는 시스템의 디자인 기준을 명확히 확립하고 범용성을 보장하게 해줍니다. 이번 글에선 현대 서비스 디자인을 RESTful하게 설계하는 기초적인 내용에 대..
Swagger: RESTful API를 설명하고 표현하기 위한 프로젝트. Swagger Specification(스펙): API를 설명하고 쉽게 표현하기 위한 정의와 규칙들의 모음.(현재 스펙 2.0) 사용상의 장점: API를 보다 이해하기 쉽도록 보여주고 다양한 프로그래밍 언어의 코드로 자동생성이 가능하다. 아울러 다양한 툴을 함께 사용하여 결과 파일이나 테스팅 용도로도 활용. 스펙 파일 포맷: 표준 JSON 또는 YAML 형태로 Swagger Spec을 저장해서 사용. 스펙 파일 구조: 한 개의 파일로 spec을 정의하지만 여러개의 파일로 spec을 나눠서 사용가능. 스키마: API 스펙을 위한 root 오브젝트로 필드(Field)의 세트들로 구성되며 이는 다시 고정형 필드와 패턴형 필드로 나뉜다.