search

square / connect-api-specification

This repository contains the OpenAPI specification as well as templates for generating SDKs for Square's APIs
https://squareup.com/developers
Apache License 2.0
72 stars 35 forks source link

api.json doesn't pass swagger spec validation #104

Open jawspeak opened 6 years ago

jawspeak commented 6 years ago

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
timtoyoshima commented 6 years ago

Thanks JAW. We'll investigate.