본문 바로가기
HTTP 의미 체계 준수 HTTP 의미 체계 준수 HTTP 사양을 준수하는 API 디자인에 대한 일반 고려 사항을 알아보자 미디어 유형 클라이언트와 서버는 Resource Representation을 교환함 POST 요청의 경우 요청 본문에 생성할 Resource의 Representation이 포함됨 GET 요청의 경우 응답 본문에 가져온 Resource의 표현이 포함됨 HTTP 프로토콜에서의 표현 형식 HTTP 프로토콜에서 형식은 MIME 유형이라고 하는 _미디어 유형_을 사용하여 지정됨 이진이 아닌 데이터의 경우 대부분의 Web API는 JSON과 XML을 지원함 JSON 미디어 유형: application/json XML 미디어 유형: application/xml 미디어 유형 지정 요청 / 응답의 Content-Type 헤.. 2023. 3. 13.
HTTP 메서드 측면에서의 API 작업 정의 HTTP 메서드 측면에서의 API 작업 정의 HTTP 프로토콜은 요청에 체계의미를 할당하는 다양한 메서드를 정의하고 있음 일반적인 HTTP 메서드 메서드 내용 응답 메세지의 본문 GET 지정된 URI에서 Resource의 Representation을 검색 요청된 Resource의 세부 정보 POST 지정된 URI에 새로운 Resouce를 생성 Resource를 생성하지 않는 작업을 수행할 수도 있음 새 Resource의 새부 정보를 제공 PUT 지정된 URI에 Resource를 생성하거나 대체 만들 또는 업데이트할 Resource를 지정 PATCH 지정된 URI에서 Resource의 부분 업데이트 수행 Resource에 적용할 변경 내용을 지정 DELETE 지정된 URI의 Resource를 제거 특정 요.. 2023. 3. 13.
RESTful Web 디자인 well-formed 웹 디자인이 지원하는 특성 플랫폼 독립성 모든 클라이언트는 내부에서 API가 구현되는 방법에 관계없이 API를 호출할 수 있어야 함 그러려면 프로토콜을 사용해야 하며, 클라이언트 및 웹 서비스가 교환할 데이터 형식에 동의할 수 있는 메커니즘이 있어야 함 서비스진화 Web API는 클라이언트 앱과 독립적으로 기능을 진화시키고 추가할 수 있어야 함 API가 진화해도 기존 클라이언트 앱은 수정없이 계속 작동할 수 있어야 함 모든 기능은 클라이언트 앱이 해당 기능을 완전히 이용할 수 있도록 검색 가능해야 함 REST란? 2000년 Roy Fielding이 제안한 서비스를 디자인하는 아키텍처 접근방식 하이퍼미디어 기반 분산 시스템을 구축하기 위한 아키텍처 스타일 REST는 어떤 기본 프로토콜.. 2023. 3. 12.