openservicebrokerapi / servicebroker

Open Service Broker API Specification
https://openservicebrokerapi.org/
Apache License 2.0
1.19k stars 436 forks source link

Swagger spec is missing service binding endpoint object + properties #741

Closed WalkerGriggs closed 3 years ago

WalkerGriggs commented 3 years ago

What is the problem?

The service broker spec defines the service binding resource and response to have a list of endpoint objects. openapi.yaml meets these requirements, but swagger.yaml is missing the endpoint object / properties.

Who does this affect?

This affects all authors and developers looking to adopt the OpenAPI v2 (Swagger) spec.

Do you have any proposed solutions?

Add the endpoint object and properties to the swagger spec.

Additional context

https://github.com/openservicebrokerapi/servicebroker/blob/45c50bb4e14fc073d7098e9891f6385949d69ecb/openapi.yaml#L947-L965

https://github.com/openservicebrokerapi/servicebroker/blob/45c50bb4e14fc073d7098e9891f6385949d69ecb/openapi.yaml#L942-L945