Вы можете преобразовать свои строки в константы или свойства или yaml, чтобы получить чистый код
@ApiParam(value = "${swagger.sample.request.ApiParam.value}")
@RequestBody(required = true)
List request,
@ApiParam(value = DocumentationConstants.SAMPLE, required = true)
@RequestHeader(value = "sample", required = true)
String example,
Ссылка: Экстернализация