Need of @apiBodyExample

[Saatwik-Mehta]

Feature request

Instead of giving the allowed values in the @apiBody parameter, it will be good to have apiBodyExample as a separate parameter, so that it is easy to show multiple body example in the docs.

@apiBodyExample {json} Request-Example with example1:
    {
      `param1`: `some value`,
      `param2`: null
    }

@apiBodyExample {json} Request-Example with example2:
    {
      `param1`: null,
      `param2`: `some value`
    }

[Saatwik-Mehta]

Any updates on this?

[NicolasCARPi]

Any updates on this?

No.

[Saatwik-Mehta]

Okay

[IVoyt]

Feature request

Instead of giving the allowed values in the @apiBody parameter, it will be good to have apiBodyExample as a separate parameter, so that it is easy to show multiple body example in the docs.

@apiBodyExample {json} Request-Example with example1:
    {
      `param1`: `some value`,
      `param2`: null
    }

@apiBodyExample {json} Request-Example with example2:
    {
      `param1`: null,
      `param2`: `some value`
    }

maybe @apiParamExample is what you looking for?