Forum Discussion

vsd_codesode's avatar
New Contributor
6 years ago

Error Sibling parameters must have unique name


I am defining two parameter for to my REST resource, with specific params as below


@Operation(description = "Download",
summary = "0000",
tags = {"Test-v1.0"},
parameters = {
@@Parameter(name = "id", description = "id", in = ParameterIn.QUERY)
@Parameter(name = "file", description = "file Name", in = ParameterIn.QUERY),
@Parameter(name = "date", description = "Kickoff Date Time", in = ParameterIn.QUERY),
public Response dowload(@QueryParam("id") String id, @QueryParam("file") String file, @QueryParam("date") String date)

So generating documnet via maven plugin. the result contains two entries for each defined paramenters. Total 6 entries into the generated documents. 


Please help me to get it resolve and make maven plugin generate only one entry in paramenter list into json.

3 Replies

  • Hi, annotate the method parameter directly, e.g.


    @Operation(description = "Download",
    summary = "0000",
    tags = {"Test-v1.0"}
    public Response download(
    @QueryParam("id") @Parameter(description = "id") String id,
    @QueryParam("file") @Parameter(description = "file") String file,
    @QueryParam("date") @Parameter(description = "date") String date)


    • vsd_codesode's avatar
      New Contributor



      I did that too and it gives expected result. But, Now all endpoints have too much data definitions. It all are too messy to read. Defining parameter is operation looks convenient to manage and read. Could you point me to some document, where this is described in details?


      • frantuma's avatar

        Not sure what do you mean by "too much data definitions", adding @Parameter to method param is less verbose than using Operatio parameters..

        Documentation about Parameter annotation is available in wiki which has links also to test cases.