Hi,
I have created OpenAPI yaml files for our APIs and validated them using https://apitools.dev/swagger-parser/online/ and https://editor.swagger.io/. Having established that the OpenAPI spec that I had created worked as I hoped when rendered by editor.swagger I uploaded it into our integrated portal. However, after a few tests I established that in cases where I want to pass multiple parameters into a url the integrated portal doesn’t seem to interpret the API spec in the same way as the tools I was using.
Expected behaviour, selecting 3 query parameters builds the following query:
‘https://api.rsc.org/compounds/v1/records/{id}/details?fields=param1,param2,param3’
where the parameters are comma delimited
What I see when I try to use the SmartDocs in the portal is:
‘https://api.rsc.org/compounds/v1/records/{id}/details?fields=param1&fields=param2&fields=param3’
… which results in the API endpoint only accepting the 1st parameter.
I am using the following fields in my OpenAPI spec:
style: “form”
explode: false
The full spec is available at:
Can anyone advise if this is an issue with the SmartDocs, and provide details as to how to get the Developer Portal to build the request that my APIs expect?