connect-api-specification icon indicating copy to clipboard operation
connect-api-specification copied to clipboard

api.json doesn't pass swagger spec validation

Open jawspeak opened this issue 7 years ago • 1 comments

I used https://github.com/square/connect-api-specification/blob/1619654739714a5b8cfe6c5b059aad67a411b482/api.json and pasted it into https://editor.swagger.io/

The following errors showed up. Note all but 1 are from the V1 endpoints:

Semantic error at paths./v1/me/locations.get.operationId
Operations must have unique operationIds.
   Jump to line 1292

Semantic error at paths./v1/{location_id}/refunds.get.operationId
Operations must have unique operationIds.
   Jump to line 2114

Semantic error at paths./v1/{location_id}/refunds.post.operationId
Operations must have unique operationIds.
   Jump to line 2175

Schema error at definitions['CatalogObject']
should NOT have additional properties
additionalProperty: example_type
   Jump to line 5983

Schema error at definitions['v1Variation'].properties['user_data'].required
should be array
   Jump to line 11662

jawspeak avatar Apr 05 '18 00:04 jawspeak

Thanks JAW. We'll investigate.

timtoyoshima avatar Apr 06 '18 15:04 timtoyoshima