REST API 설계 (2) 썸네일형 리스트형 [ Rest API ] REST API 특징 REST API 특징 리소스 중심적 API 는 리소스를 중심으로 구성 되어야 한다. 이전에 언급 했듯이 리소스는 서비스가 리소스를 클라이언트에게 제공할 수 있게 정보를 추상화 한 것이다. 리소스의 내부 구조는 API 를 통해 유출되지 않아야 한다. 예를 들어 주문의 세부 사항은 관계형 데이터 베이스네 개별적으로 저장 될 수 있으므로 해당 내부 구조를 반영하도록 여러 리소스를 생성해서는 안된다. API 는 비지니스 실체에 초점을 맞춰 구현 세부 사항을 숨기기 위한 추상화로써 리소스를 사용해 API 구현을 진화 시킬 수 있어야 한다. URL 을 통한 식별 가능 리소스는 URL 을 통해 식별 할 수 있어야 한다. 이는 동사 대신 명사를 기반으로 한다. 리소스의 컬렉션을 식별하는 해당 URL 은 복수형이어야 한.. [ Rest API ] REST 인터페이스의 제약 사항 REST 인터페이스의 제약 사항 리소스 식별 REST 에서 리소스는 서비스에서 리소스를 클라이언트에게 제공할 수 있게 하는 정보를 추상화 한 것이다. 본질적으로 리소스는 사용자나 문서, 이미지, 작업 일 수 있다. 리소스는 URL 를 통해 고유하게 식별 할 수 있어야 한다. 예를 들어 다음과 같은 URL 은 ID 가 1인 작업을 고유하게 식별한다. https://api.example.com/v1/tasks/1 해당 URL 에서 보다시피 URL 에 버전 번호인 v1 을 추가한다. 어떤 사람들은 버전 정보를 리소스 URL 에 넣는 것은 나쁜 습관 이라고 생각한다. 그들은 그것을 HTTP 요청 헤더에 추가하는 것을 선호한다. 다른 사람들은 Restful API 를 만들 때 버전 관리를 사용하는 것 자체가 옳지.. 이전 1 다음