nsip / specgen_input_au

Capture of specgen input files
2 stars 0 forks source link

create{Payload} and update{Payload} keys not accepted #50

Closed opoudjis closed 1 year ago

opoudjis commented 1 year ago

960 of the 11398 errors are of type:

Error spec rule :: Property create/update{...} is not expected here.

For example,

components/schemas/requestPayloads/updateSchoolInfo:

Property updateSchoolInfo is not expected here.

I believe the issue is that /components/schemas needs to map to only one level of /keyword/Schema, and OpenAPI does not accept requestPayloads as an intervening hierarchical level. To be compliant, we need to remove requestPayloads and responsePayloads as an intermediate level; replacing the "/" with "-" would be the simplest fix.

This has significant ramifications downstream of course for anything that invokes those schema definitions.

opoudjis commented 1 year ago

The structure of schemas: was incorrect: requests and responses are supposed to be siblings of schemas, not children of it.