Any way of using properties from application.yml as schema example?

I’m trying to set an example for an endpoint schema, but I’d like to keep the example in a property files, like application.yml. Is there any way of using it in the example?

I tried the following code, but it didn’t work:

@Operation(summary = "Something something")
@ApiResponses(value = {
        @ApiResponse(responseCode = "200", description = "Successful operation",
                content = @Content(schema = @Schema(example = "${swagger.examples.fooApi}")))
})
@GetMapping(path = "/foo/{bar}", produces = APIVersions.API_VERSION_V1)
public ResponseEntity getFoo(@PathVariable("bar") @LogParameter final String bar) {
    return ResponseEntity.ok(this.fooService.getFoo(bar));
}

[edgeofoblivion]

I’d be interested in a way to load detailed operation descriptions (containing markdown) from yaml, something like:

@Operation(summary = "This API will do something.", description = "${springdoc.operation-descriptions.myOperation}")

This would keep the controller class less polluted when providing a detailed, formatted description.

Thanks.

[johnheitor]

Fantastic news. Thank you for adding support.