조건부로 응답을 리턴하는 Spring REST Docs로 REST 서비스를 문서화하는 방법은 무엇입니까?

Question

리소스 당 액세스 제한이있는 REST 서비스가 있습니다.

GET/기록/{recordId를}

레코드 당 액세스 수를 정의하고 한계에 도달하면, 예외를 반환의 내가 다음과 같은 서비스를했습니다한다고 가정 해 봅시다.

나는 액세스 제한이 5 인 레코드를 생성하고 mockMvc를 통해 요청을 보내는 루프를 생성하는 통합 테스트를 작성했습니다.

Spring REST Docs의 예제를 보면 테스트 직후에 .andDo (...)가 추가 된 것을 볼 수 있습니다. 동일한 테스트의 스 니펫을 덮어 쓰는 것이 두렵습니다. 리소스에 resourceId 당 액세스 제한이 있음을 문서화하고 리소스에 액세스 할 수 있고 액세스 제한에 도달했을 때 예제를 제공하고 싶습니다.

이 경우 두 개의 문서 ID를 사용해야합니까? (아래 참조) 이것이 올바른 접근 방법입니까?

Answer 1

네,이 두 가지 경우에 서로 다른 두 개의 문서 ID를 사용하여 둘 모두에 대한 스 니펫 세트를 얻을 수 있습니다.

필요하지 않지만 첫 번째 호출에는 한 번만 성공한 다음 마지막 호출에는 한 번만 도달 할 것으로 예상되면 루프에서 두 번만 문서를 호출하는 것이 좋습니다.