Rest API Swagger

Hi,

I am trying to validate the Cuba Platform Rest API for 7.1 using the Swagger Editor and get the following error:

Errors

Structural error at definitions.fileInfo.properties.size.type
should be equal to one of the allowed values
allowedValues: array, boolean, integer, number, object, string
Jump to line 402
Semantic error at paths./entities/{entityName}/search
Declared path parameter "entityName" needs to be defined within every operation in the path (missing in "post"), or moved to the path-level parameters object
Jump to line 721
Structural error at paths./entities/{entityName}/search.get.parameters.1
should have required property 'required'
missingProperty: required
Jump to line 800
Structural error at paths./entities/{entityName}/search.get.parameters.1
should have required property 'type'
missingProperty: type
Jump to line 800
Semantic error at paths./entities/{entityName}/search.get.parameters.1
Path parameters must have 'required: true'. You can always create another path/operation without this parameter to get the same behaviour.
Jump to line 800
Structural error at paths./files/{id}.get.parameters.0
should have required property 'required'
missingProperty: required
Jump to line 1177
Semantic error at paths./files/{id}.get.parameters.0
Path parameters must have 'required: true'. You can always create another path/operation without this parameter to get the same behaviour.
Jump to line 1177
Structural error at paths./docs/swagger.{format}.get.parameters.0
should have required property 'required'
missingProperty: required
Jump to line 1444
Semantic error at paths./docs/swagger.{format}.get.parameters.0
Path parameters must have 'required: true'. You can always create another path/operation without this parameter to get the same behaviour.
Jump to line 1444

Is there a problem with the REST API Swagger Format for Cuba Platform?
Is Cuba Platform Swagger REST API valid?
Why is it displaying this error?

Thank you.

Kind Regards,
John

Hi,
probably you’re right and there are some errors there. I’ve created an issue: rest-api-swagger.yaml doesn't fully conforms to the specification · Issue #97 · cuba-platform/restapi · GitHub. Thanks for pointing out!

But I don’t see it as a big problem, since this rest-api-swagger.yaml file is used only for displaying docs at Swagger UI