Я пытаюсь создать документ с аннотациями чванства. Когда я генерирую файл yml, я вижу много ошибок, таких как: «$ refs должен ссылаться на правильное местоположение в документе» для кодов ошибок.
Даже когда я не определяю ответ об ошибке, я вижу: $ ref: '# / definitions / ErrorResponse'. Я вижу ту же строку для определенных ответов об ошибках.
Вот пример кода:
@ApiOperation(value = "Get details about an account")
@ApiResponses({
@ApiResponse(code = 401, message = "Unauthorized : Account ID unknown", response = ServiceErrorResponse.class),
@ApiResponse(code = 401, message = "Unauthorized : Unknown consent", response = ServiceErrorResponse.class),
@ApiResponse(code = 403, message = "Consent unknown", response = BerlinGroupErrorResponse.class),
@ApiResponse(code = 503, message = "Service unavailable")
})
AccountResponse getAccountDetails(@ApiParam(value = "Account identifier", required = true) String accountId,
@ApiParam(value = "Include the booking balance in the account details") Boolean withBalance);
И ServiceErrorResponse с аннотацией @ApiModel (description = "Дополнительная информация об ошибке")