REST API의 많은 유사한 리소스

Question

나는 멀티미디어 서비스 용 API를 개발 중입니다. 데이터베이스에는 다양한 미디어 (영화, 음악, 시리즈 등)를 저장하는 미디어 테이블이 있습니다. 관리자와 사용자의 두 가지 유형의 사용자가 있습니다.

• /영화
• /만화
• /음악
• /시리즈
  • /계절
    • /에피소드
    :

    사용자 다른 엔드 포인트를 사용하여 미디어에 액세스 할 수 있습니다

• 등

각 엔드 포인트는 미디어 유형에 대한 특정 데이터 만 반환합니다. 각 엔드 포인트에는 특정 검색 인수가 있습니다.

관리자 용 API는 공개되지 않습니다. 미디어 유형을 제어하는 ​​단일 끝점을 만드는 것이 정상입니까? 예를 들어, 다른 미디어 유형을 CRUD하는 데 사용되는 /media 끝점을 만들 수 있습니다.

다른 프로젝트의 사용자를 위해 관리자 용 API와 API를 분리해야합니까?

리소스에 관리자와 사용자가 다른 필드가있는 상황을 어떻게 처리해야합니까?

Answer 1

관리자와 사용자가 서로 다른 필드를 갖는 상황을 어떻게 처리해야합니까?

다른 프로젝트의 사용자를 위해 관리자 용 API와 API를 분리해야합니까?

아마도. 리소스가 웹용 도메인 모델을 "채택"한다는 사실을 명심하는 것이 도움이 될 수 있습니다.

웹은 귀하의 도메인이 아니라 문서 관리 시스템입니다. 모든 HTTP 동사는 문서 관리 도메인에 적용됩니다. URI는 캡슐화를 위반하는 도메인 객체에 매핑되지 않습니다. 작업 (예 : 도메인 모델에 명령 실행)은 자원 관리의 부작용입니다. 즉, 자원은 반부패 계층의 일부입니다. 비즈니스 도메인의 비즈니스 개체보다 통합 도메인에서 훨씬 많은 리소스가 필요합니다. - Jim Webber