Ask questionsArbitrary query parameter names?
I'm pretty new to openapi, so apologies if this has been asked before. I haven't been able to find a similar question anywhere.
I'm working creating an openapi.yml for an existing API we have at my workplace.
For better or worse, the API supports arbitrary query parameter names. Values are always supplied. These pairs are interpreted as tag name/value pairs of particular resources (computational resources). Here are a few examples (with some name simplifications) of how the API can be invoked:
GET /resources?state=active&tagName1=tagValue1&tagName2=tagValue2 GET /resources?tagName6=tagValue6 GET /resources?state=active
tagValueN's are user-supplied and arbitrary, but have to conform to be "identifier names" (no spaces, alphanumeric, must not start with a digit).
The only query parameter with a fixed, known name is
Is there some way of expressing this notion in openapi?
I appreciate this is pretty unusual, and perhaps the description might be the only means to express this.
For reference here's a section of my openapi.yml file for this endpoint.
openapi: 3.0.0 info: title: Service description: Endpoints version: 1.0.0 paths: /resources: get: parameters: - in: query name: state schema: type: string enum: - active - inactive - in: query # TODO - how to describe tagNameN/tagValueN here? responses: '200': description: "All resources successfully obtained."
Any insights or advice appreciated.
Thanks in advance.
Answer questions danieljacobs1
... can be defined as a single parameter whose value is a dictionary ...
Unfortunately, I'm not at liberty to change the API at the moment. The tag names have to be the query string parameter names as this is an existing API with many clients.
The dictionary value would be a good approach going forward for new endpoints.