Skip to content
This repository has been archived by the owner on May 23, 2024. It is now read-only.

@api‐queryparam

Jon Ursenbach edited this page Jan 4, 2020 · 2 revisions

A request parameter that can be supplied to a resource action via the query string.

If you need to describe a parameter that can be used within a body payload, use the @api-param annotation.

The syntax for this is exactly the same as @api-param.

Examples

Using a token:

@api-queryparam:public {page}

Using a token with available values:

@api-queryparam:public {filter}
    + Members
        `embeddable`
        `playable`

With a vendor tag:

@api-queryparam:public locked_down (string, needs:SomeApplicationFeature) - This is a cool thing.

Normal usage with acceptable values:

@api-queryparam:private __testing (string) - This does a thing.
    + Members
        - `true`
        - `false`